New to Kendo UI for AngularStart a free 30-day trial

NavigatorSeriesItemComponent

Represents a series item in the StockChart navigator (see example).

html
<kendo-stockchart>
 <kendo-chart-navigator>
  <kendo-chart-navigator-series>
   <kendo-chart-navigator-series-item type="area" [data]="data" field="value" categoryField="date">
   </kendo-chart-navigator-series-item>
  </kendo-chart-navigator-series>
 </kendo-chart-navigator>
<kendo-stockchart>

Selector

kendo-chart-navigator-series-item

Inputs

NameTypeDefaultDescription

aggregate

any

'max'

Specifies the aggregate function for the date series. Use this function when a category (year, month, or other) contains two or more points. The Chart displays the return value of the function instead of the individual points. Use the aggregate option with categorical chart axis only.

The supported values are:

  • "avg"—The average of all values for the date period.
  • "count"—The number of values for the date period.
  • "max"—The highest value for the date period.
  • "min"—The lowest value for the date period.
  • "sum"—The sum of all values for the date period. Defaults to 0 if no data points are defined.
  • "sumOrNull"—The sum of all values for the date period. Defaults to null if no data points are defined.
  • "first"—The first value.
  • function (values, series, dataItems, category)—A user-defined aggregate function. Returns a single value or a data item.
  • object (compound aggregate)—Applicable to the Candlestick, Box Plot, and OHLC series. Specifies the aggregate for each data item field.

autoFit

boolean

false

Determines whether the Chart automatically scales down to fit the content area. Applicable for the Pie and Donut series. (See example).

axis

string

'primary'

Specifies the name of the value axis. Use this option for Scatter plots. For more information on Scatter plots, refer to xAxis and yAxis.

border

Border

Specifies the border configuration of the series.

categoryAxis

string

Specifies the name of the category axis.

categoryField

string

'category'

Specifies the data item field which contains the category name or date. If the category is a date, the points are rendered in chronological order.

closeField

string

'close'

Specifies the data field that contains the close value. Use the closeField option when series.type is set to "candlestick" or "ohlc".

color

any

Specifies the color of the series.

colorField

string

'color'

Specifies the data item field which contains the series color. Use the colorField option when series.type is set to "bar", "column", "rangeBar", "rangeColumn", "bubble", "donut", "pie", "candlestick", "ohlc", or "waterfall".

connectors

LabelConnectors

Specifies the connectors configuration for the labels.

currentField

string

'current'

Specifies the data item field which contains the current value. Use the currentField option when series.type is set to "bullet" or "verticalBullet".

dashType

DashType

'solid'

Specifies the dash type of line Chart. Use the dashType option only if the series.type option is set to "line".

data

any[]

Specifies the data source for the series.

downColor

string

Specifies the color that is applied when the close value is less than the open value.

downColorField

string

'downColor'

Specifies the data field which contains the color that is applied when the open value is greater than the close value. Use the downColorField option when series.type is set to "candlestick".

dynamicHeight

boolean

true

Use the dynamicHeight option when series.type is set to "funnel" or "pyramid". Determines whether all segments become with the same height. When set to false, all segments have the same height. Otherwise, the height of each segment is based on its value.

dynamicSlope

boolean

false

Use this option when series.type is set to "funnel". Determines whether the ratio of the bases of each segment is calculated based on the ratio of currentDataItem.value/nextDataItem.value. The last element is always created like a rectangle since there is no following element.

errorBars

SeriesErrorBars

Specifies the configuration options of the series error bars.

errorHighField

string

'errorHigh'

Specifies the data item field which contains the series.errorBars high value. Use the errorHighField option when series.type is set to "bar", "column", "line", or "area".

errorLowField

string

'errorLow'

Specifies the data item field which contains the series.errorBars low value. Use the errorLowField option when series.type is set to "bar", "column", "line", or "area".

explodeField

string

'explode'

Specifies the data item field which contains a Boolean value indicating whether the sector is exploded. Use the explodeField option when series.type is set to "donut" or "pie".

extremes

SeriesExtremes

Specifies the configuration options of the series extremes.

field

string

'value'

Specifies the data item field which contains the series value.

for

string

Specifies the name of the series for which the current series serves as a trendline.

fromField

string

'min'

Specifies the data item field which contains the series from value.

gap

number

1.5

Specifies the distance between the categories expressed as a percentage of the bar width. See the related spacing setting. Use the gap option when series.type is set to "bar", "column", "candlestick", "ohlc", "radarColumn", or "waterfall".

highField

string

'high'

Specifies the data field which contains the high value. Use the highField option when series.type is set to "candlestick" or "ohlc".

highlight

SeriesHighlight

Specifies the configuration options of the series highlight.

holeSize

number

Specifies the size of the hole in donut charts.

labels

SeriesLabels

Specifies the configuration options of the series labels.

legendItem

LegendItem

Specifies the configuration options of the series legend item.

line

SeriesLine

Specifies the line configuration of the series.

lowerField

string

'lower'

Specifies the data item field which contains the series lower value. Use the lowerField option when series.type is set to "boxPlot".

lowField

string

'low'

Specifies the data field containing the low value. Use the lowField option when series.type is set to "candlestick" or "ohlc".

margin

number | Margin

1

Specifies the margin around each donut series (ring). A numeric value sets all margins.

markers

SeriesMarkers

Specifies the configuration options of the series markers.

maxSize

number

100

Specifies the maximum size of the Chart bubble series marker.

mean

SeriesMean

Specifies the mean configuration of the series.

meanField

string

'mean'

Specifies the data item field which contains the series mean value. Use the meanField option when series.type is set to "boxPlot".

median

SeriesMedian

Specifies the median configuration of the series.

medianField

string

'median'

Specifies the data item field which contains the series median value. Use the medianField option when series.type is set to "boxPlot".

minSize

number

5

Specifies the minimum size of the Chart bubble series marker.

missingValues

"gap" | "interpolate" | "zero"

Specifies how to handle missing values in the series.

name

string

Specifies the name of the series.

neckRatio

number

0.3

Specifies the top-base/bottom-base ratio of the whole Funnel Chart. If the neckRatio is set to 3, it means the top base is three times smaller than the bottom base. Use the neckRatio option when series.type is set to "funnel" and dynamicSlope is set to false.

negativeColor

string

Specifies the color for negative values.

negativeValues

NegativeBubbleValues

Specifies the configuration for negative bubble values.

notes

SeriesNotes

Specifies the configuration options of the series notes.

noteTextField

string

'noteText'

Specifies the data item field which contains the series note text.

opacity

number

1

Specifies the opacity of the series. By default, the series are opaque.

openField

string

Specifies the data field that contains the open value.

outliers

SeriesOutliers

Specifies the configuration options of the series outliers.

outliersField

string

'outliers'

Specifies the data item field which contains the series outliers value. Use the outliersField option when series.type is set to "boxPlot".

overlay

Overlay

Specifies the overlay configuration of the series.

padding

number

Specifies the padding of the series.

pattern?

SeriesPattern | (point: any) => SeriesPattern

Specifies the configuration options of the series pattern.

patternField?

string

Specifies the data item field that contains the series pattern. The patternField option is supported when series.type is set to "pie", "donut", "funnel", "heatmap", or "pyramid".

q1Field

string

'q1'

Specifies the data item field which contains the series q1 value. Use the q1Field option when series.type is set to "boxPlot".

q3Field

string

'q3'

Specifies the data item field which contains the series q3 value. Use the q3Field option when series.type is set to "boxPlot".

segmentSpacing

number

0

Specifies the space in pixels between the different segments of the Funnel or Pyramid Chart. Use the segmentSpacing option when series.type is set to "funnel" or "pyramid".

size

number

Specifies the size of the series.

sizeField

string

'size'

Specifies the data field which contains the bubble size value.

spacing

number

0.4

Specifies the distance between series points within a category. Expressed as a percentage of the bar width. See the related gap setting. Use the spacing option when series.type is set to "bar", "column", "candlestick", "ohlc", or "radarColumn".

stack

string | boolean | SeriesStack

false

Determines whether the series have to be stacked. A string value is interpreted as series.stack.group.

Use the stack option when series.type is set to "bar", "column", "line", "area", "verticalLine", "verticalArea", "radarLine", "radarArea", and "radarColumn". If not overridden, the stack settings of the first series are inherited as a default value by the rest of the series.

startAngle

number

90

Specifies the start angle (in degrees) of the first Donut or Pie segment. Use positive values to increase angles clockwise with zero to the left. Negative values are acceptable.

style

LineStyle

'normal'

Specifies the line style configuration of the series. Use the style option when series.type is set to "line", "scatterLine", "radarLine", or "polarLine".

summaryField

string

'summary'

Specifies the data item field which contains the summary type for the Waterfall series. The value (if any) of a data item marked as a summary point will be discarded.

Summary columns are optional and can be one of two types:

"runningTotal"—Displays the sum of all items since the last "runningTotal" point. "total"—Displays the sum of all previous items.

target

BulletTarget

Specifies the bullet target configuration.

toField

string

'max'

Specifies the data item field which contains the series to value.

tooltip

SeriesTooltip

Specifies the configuration options of the series tooltip.

trendline

SeriesTrendline

Specifies the configuration options of the trendline series.

The trendline option is supported when series.type is set to "linearTrendline", "exponentialTrendline", "logarithmicTrendline", "powerTrendline", "polynomialTrendline" or "movingAverageTrendline".

type

SeriesType

'column'

Specifies the type of the series.

upperField

string

'upper'

Specifies the data item field which contains the series upper value. Use the upperField option when series.type is set to "boxPlot".

visible

boolean

true

Determines whether the Chart series is visible.

visibleInLegend

boolean

true

Determines whether to show the point category (for Funnel, Pyramid, Donut, and Pie series) or the series name (for other available series types) in the legend.

visibleInLegendField

string

Specifies the data item field which contains the visibility state in the legend.

visual

(e: SeriesVisualArgs) => Element

Specifies a function that returns a custom visual for the series.

whiskers

SeriesWhiskers

Specifies the whiskers configuration of the series.

width

number

Specifies the width of the series.

xAxis

string

'primary'

Specifies the name of the X axis. Use the xAxis option when series.type is set to "bubble", "scatter", "scatterLine", or "polar" series. For the Polar series, the xAxis range is expressed in degrees.

xErrorHighField

string

'xErrorHigh'

Specifies the data item field which contains the series.errorBars xAxis high value. Use the xErrorHighField option when series.type is set to "scatter", "scatterLine", or "bubble".

xErrorLowField

string

'xErrorLow'

Specifies the data item field which contains the series.errorBars xAxis low value. Use the xErrorLowField option when series.type is set to "scatter", "scatterLine", or "bubble".

xField

string

'x'

Specifies the data item field containing the x value. Use the xField option when series.type is set to "bubble", "scatter", "scatterLine", or "polar" series.

yAxis

string

'primary'

Specifies the name of the Y axis to use. Available for the Bubble, Scatter, Scatter Line, and Polar series.

yErrorHighField

string

'yErrorHigh'

Specifies the data item field that contains the series.errorBars yAxis high value. The yErrorHighField option is supported when series.type is set to "scatter", "scatterLine", or "bubble".

yErrorLowField

string

'yErrorLow'

Specifies the data item field that contains the series.errorBars yAxis low value. The yErrorLowField option is supported when series.type is set to "scatter", "scatterLine", or "bubble".

yField

string

'y'

Specifies the data item field that contains the y value. The yField option is supported when series.type is set to "bubble", "scatter", or "scatterLine".

zIndex

number

Specifies the z-index of the series.

Methods

notifyChanges

Updates the component fields with the specified values and refreshes the Chart.

Use this method when the configuration values cannot be set through the template.

ts
item.notifyChanges({ visible: true });
Parameters

changes

any

An object containing the updated input fields.

togglePointVisibility

Toggles the visibility of a point with the given index. Applicable for the Pie, Donut, Funnel and Pyramid series.

Parameters

pointIndex

number

The zero-based index of the point to toggle.

toggleVisibility

Toggles the series visibility and updates the parent Chart without animated transitions.

In this article
SelectorInputsMethods
Not finding the help you need?
Contact Support