LegendSettings API in JavaScript Range Navigator API control

Configures the legends in charts.

Properties

alignment

string

Legend in chart can be aligned as follows:

• Near: Aligns the legend to the left of the chart.
• Center: Aligns the legend to the center of the chart.
• Far: Aligns the legend to the right of the chart.

Defaults to ‘Center’

background

string

The background color of the legend that accepts value in hex and rgba as a valid CSS color string.

Defaults to ‘transparent’

border

[ [[BorderModel](./borderModel)](./ [BorderModel](./borderModel))](./ [ [BorderModel](./borderModel)](./ [BorderModel](./borderModel)))

Options to customize the border of the legend.

containerPadding

[ [[ContainerPaddingModel](./containerPaddingModel)](./ [ContainerPaddingModel](./containerPaddingModel))](./ [ [ContainerPaddingModel](./containerPaddingModel)](./ [ContainerPaddingModel](./containerPaddingModel)))

Options to customize left, right, top and bottom padding for legend container of the chart.

description

string

Description for legends.

Defaults to null

enablePages

boolean

If set to true, legend will be visible using pages.

Defaults to true

height

string

The height of the legend in pixels.

Defaults to null

location

[ [[LocationModel](./locationModel)](./ [LocationModel](./locationModel))](./ [ [LocationModel](./locationModel)](./ [LocationModel](./locationModel)))

Specifies the location of the legend, relative to the chart. If x is 20, legend moves by 20 pixels to the right of the chart. It requires the position to be Custom.

<div id='Chart'></div>

let chart: Chart = new Chart({
...
  legendSettings: {
    visible: true,
    position: 'Custom',
    location: { x: 100, y: 150 },
  },
...
});
chart.appendTo('#Chart');

margin

[ [[MarginModel](./marginModel)](./ [MarginModel](./marginModel))](./ [ [MarginModel](./marginModel)](./ [MarginModel](./marginModel)))

Options to customize left, right, top and bottom margins of the chart.

maximumTitleWidth

number

maximum width for the legend title.

Defaults to 100

mode

string

Mode of legend items

• Series: Legend items generated based on series count.
• Point: Legend items generated based on unique data points.
• Range: Legend items generated based on range color mapping property.
• Gradient: Single linear bar generated based on range color mapping property. This property is applicable for chart component only.

opacity

number

Opacity of the legend.

Defaults to 1

padding

number

Option to customize the padding between legend items.

Defaults to 8

position

string

Position of the legend in the chart are,

• Auto: Places the legend based on area type.
• Top: Displays the legend at the top of the chart.
• Left: Displays the legend at the left of the chart.
• Bottom: Displays the legend at the bottom of the chart.
• Right: Displays the legend at the right of the chart.
• Custom: Displays the legend based on the given x and y values.

Defaults to ‘Auto’

shapeHeight

number

Shape height of the legend in pixels.

Defaults to 10

shapePadding

number

Padding between the legend shape and text.

Defaults to 5

shapeWidth

number

Shape width of the legend in pixels.

Defaults to 10

tabIndex

number

TabIndex value for the legend.

Defaults to 3

textStyle

[ [[FontModel](./fontModel)](./ [FontModel](./fontModel))](./ [ [FontModel](./fontModel)](./ [FontModel](./fontModel)))

Options to customize the legend text.

title

string

Title for legends.

Defaults to null

titlePosition

string

legend title position

Defaults to ‘Top’

titleStyle

[ [[FontModel](./fontModel)](./ [FontModel](./fontModel))](./ [ [FontModel](./fontModel)](./ [FontModel](./fontModel)))

Options to customize the legend title.

toggleVisibility

boolean

If set to true, series’ visibility collapses based on the legend visibility.

Defaults to true

visible

boolean

If set to true, legend will be visible.

Defaults to true

width

string

The width of the legend in pixels.

Defaults to null