0.4.3 • Published 6 years ago

@recogizer/angular-gauge-chart v0.4.3

Weekly downloads
105
License
MIT
Repository
github
Last release
6 years ago

Angular Gauge Chart

This is an angular wrap-over for the library gauge-chart

A library for creating nice and flexible gauge charts with Angular.

You can catch us on twitter: @recogizer or head over to our company's website.

Demo | Docs

Installation

  npm install @recogizer/angular-gauge-chart

Usage

Import angular-gauge-chart into your module and add as a declaration.

import { GaugeChartComponent } from 'angular-gauge-chart'

declarations: [
    GaugeChartComponent,
]

Create an element for positioning gauge in your html file:

<gauge-chart
    [canvasWidth]="canvasWidth"
    [needleValue]="needleValue"
    [centralLabel]="centralLabel"
    [options]="options"
    [name]="name"
    [bottomLabel]="bottomLabel"></gauge-chart>

Now you're ready to draw your own gauge.

Just copy to your ts file the following code:

public canvasWidth = 300
public needleValue = 65
public centralLabel = ''
public name = 'Gauge chart'
public bottomLabel = '65'
public options = {
    hasNeedle: true,
    needleColor: 'gray',
    needleUpdateSpeed: 1000,
    arcColors: ['rgb(44, 151, 222)', 'lightgray'],
    arcDelimiters: [30],
    rangeLabel: ['0', '100'],
    needleStartValue: 50,
}

Result:

Gauge Example

Feel free to change or delete any of the gaugeOptions properties as long as their values are in permitted ranges.

Options

canvasWidth: number

needleValue: number

centralLabel: string

options = { ... } :

NameValues RangesDescription
hasNeedletrue / falsedetermines whether to show the needle or not
needleColorvalue supported by CSScolorizes needle with specified colors
needleUpdateSpeednumber larger than 0determines the speed of needle update animation
arcColorsarray of values supported by CSScolorizes gauge with specified color
arcDelimitersarray of numbers from 0 to 100specifies delimiters of the gauge in ascending order
rangeLabelarray of two stringsdepicts gauge ranges on both sides of the chart
centralLabelstringdepicts gauge inner label

name?: string (will be shown above the gauge)

nameFont?: number (font size of the name)

bottomLabel?: string (will be shown bellow the gauge)

bottomLabelFont?: number (font size of the bottom label)

Examples

Some examples of what you can get out of the library using different properties:

Gauge Examples

Contributing

Build the library with npm run build. This will fetch all dependencies and then compile the dist files. To see the examples locally you can start a web server with npm start and go to localhost:3000.

License

MIT License. Copyright (c) 2017-2018 RECOGIZER GROUP GmbH.

Authors

Alexey Karpov, Maxim Maltsev.