JSignage:Graph:Axis styling attributes
Appearance
This page is related to axis styling attributes of jSignage Graph API.
Continuous axis styling object
The customization of a continuous axis is done through a styling object (Plain Object) that contains any of the following attributes:
axis
,direction
,gridlines
,textPlacement
,textStyle
,tickMarks
- Common axis styling attributes to both types of axes.
baseline
- Type: Number.
- Position of the baseline. Must be between
minValue
andmaxValue
. The default value is calculated as:0
ifminValue
is negative andmaxValue
is positive.minValue
ifminValue
is positive.maxValue
ifmaxValue
is negative.
baselineStrokeStyle
- Type: Plain Object.
- Stroke styling object to override the
baselineStrokeStyle
of the chart. - If set to
null
, the drawing of the baseline is disabled.
format
- Type: String. Default: The default decimal number format of the locale, or the default percentage format whichever is appropriate for the chart type.
- Pattern string used to format the value next to tick marks into text as following:
''
for decimal,'E'
for scientific,'%'
for percent,'$'
for currency or an explicit number format pattern. - The
locale
parameter of the chart controls which locale is used together with the pattern; if not provided, then the global jSignage locale is used.
maxValue
- Type: Number. Default: Chosen automatically according to the source data.
- Value mapping to the end of the axis line.
minValue
- Type: Number. Default: Chosen automatically according to the source data.
- Value mapping to the start of the axis line.
minorGridlines
- Type: Boolean or Plain Object.
- Controls if minor gridlines are drawn.
- If set to
false
ornull
, minor gridlines are not drawn. - If set to
true
, minor gridlines are drawn according to the default parameters below. - If an object is provided, the following properties are used:
count
- Type: Number.
- Number of minor gridlines between each major gridline.
- Default:
4
.
strokeStyle
- Type: Plain Object.
- Stroke styling object to override the default style consisting of the stroke style used for major gridlines with half the line width.
minorTickMarks
- Type: Boolean or Plain Object.
- Controls if minor tick marks are drawn between major tick marks.
- If set to
false
ornull
, minor tick marks are not drawn. - If set to
true
, minor tick marks are drawn according to the default parameters below. - If an object is provided, the following properties are used:
count
- Type: Number.
- Number of minor tick marks between each major tick mark.
length
- Type: Number. Default: half the length or major tick marks.
- Length in pixel of the minor mark. Not that if placement is across, the actual length will be double.
strokeStyle
- Type: Plain Object.
- Stroke styling object as an override to the stroke style used for major tick marks.
tickInterval
- Type: Number or String. Default:
'medium'
. - Control the interval between ticks. The ticks are placed at regular locations on each side of the baseline. Instead of a number, the following value can be used to let jSignage.Graph choose the tick interval automatically:
'small'
Choose the interval so that between 6 and 8 ticks are used.'medium'
Choose the interval so that between 4 and 6 ticks are used.'large'
Choose the interval so that between 3 and 4 ticks are used.'max'
Position a tick on the baseline, one atminValue
and one atmaxValue
.
- Type: Number or String. Default:
ticks
- Type: Array.<Number or Plain Object>.
- Optional array of tick positions that override the
tickInterval
parameter. Each element of the array is either a value at which to position a tick or an object with the following properties:v
: The tick value.f
: The text attached to the tick. If not provided,format
is used to transform the tick value into the tick text. Added in 3.2.0 release.
Discrete axis styling object
The customization of a continuous axis is done through a styling object (Plain Object) that contains any of the following attributes:
axis
,direction
,gridlines
,textPlacement
,textStyle
,tickMarks
- Common axis styling attributes to both types of axes.
categories
Common axis styling attributes
The following attributes are common to both types of axes:
axis
- Type: Boolean or Plain Object.
- Controls if the axis line is drawn.
- If set to
false
ornull
, the axis line is not drawn. Ticks marks are disabled as well, but text and gridlines are still available. - If set to
true
, the axis line is drawn according to theaxisStrokeStyle
parameter of the chart. - If an object is provided, the following property is used:
strokeStyle
- Type: Plain Object
- Stroke styling object to override the
axisStrokeStyle
parameter of the chart.
direction
- Type: Number. Default:
1
. - Controls the direction along the axis line.
- If the axis is horizontal,
1
stands for left to right,-1
for right to left. - If the axis is vertical,
1
stands for bottom to top,-1
for top to bottom.
- Type: Number. Default:
gridlines
- Type: Boolean or Plain Object.
- Controls if gridlines are drawn.
- If set to
false
ornull
no gridline is drawn. - If set to
true
, gridlines are drawn according to thegridlineStrokeStyle
attribute of the chart. - If an object is provided, the following property is used:
strokeStyle
- Type: Plain Object.
- Stroke styling object to override the
axisStrokeStyle
parameter of the chart.
textPlacement
- Type: String.
- Where to put the text next to each tick. The following values are accepted:
'none'
: Do not display text next to the tick marks.'outside'
: Text is centered on the tick mark or gridline on the outer side of the axis line.'inside'
: Text is centered on the tick mark on the inner side of the axis line.'above'
: Text is above the gridline on the inner side of the axis line.'below'
: Text is below the gridline on the inner side of the axis line.
textStyle
- Type: Plain Object.
- Text styling object to override the default text style of the chart.
tickMarks
- Type: Boolean or Plain Object.
- Controls if tick marks are drawn.
- If set to
false
ornull
, tick marks are not drawn. This disables minor tick marks as well. - If set to
true
, tick marks are drawn according to the default parameters below. - If an object is provided, the following properties are used:
placement
- Type: String.
- One of
'inside'
,'outside'
or'across'
.
length
- Type: Number. Default: half the font size.
- Length in pixel of the mark. Not that if placement is across, the actual length will be double.
strokeStyle
- Type: Plain Object.
- Stroke styling object to override the stroke style used for the axis line.