@progress/kendo-react-charts
Version:
React Chart renders a wide range of high-quality data visualizations. KendoReact Charts package
81 lines (80 loc) • 4.3 kB
TypeScript
/**
* @license
*-------------------------------------------------------------------------------------------
* Copyright © 2026 Progress Software Corporation. All rights reserved.
* Licensed under commercial license. See LICENSE.md in the package root for more information
*-------------------------------------------------------------------------------------------
*/
import { drawing } from '@progress/kendo-drawing';
import { Border, Margin, Padding, SeriesLabelsVisualArgs } from '../../common/property-types.js';
import { SeriesDefaultsLabelsFrom } from './labels.from.interface.js';
import { SeriesDefaultsLabelsTo } from './labels.to.interface.js';
/**
* @hidden
*/
export interface SeriesDefaultsLabels {
/**
* The background color of the labels. Accepts a valid CSS color string, including hex and rgb.
*/
background?: string;
/**
* The border of the labels.
*/
border?: Border;
/**
* The text color of the labels. Accepts a valid CSS color string, including hex and rgb.
*/
color?: string;
/**
* The function which returns the Chart series labels content. You can split the text into multiple lines by using line feed characters (`"\n"`).
*
* The available fields in the function argument are:
* - `category`—The category name. Available for the Area, Bar, Column, Bubble, Donut, Funnel, Pyramid, Line, and Pie series.
* - `dataItem`—The original data item used to construct the point. If binding to an array, it will be `null`.
* - `percentage`—The point value represented as a percentage value. Available for the Donut, Funnel, Pyramid and Pie series.
* - `series`—The data series.
* - `value`—The point value. Can be a number or object containing each bound field.
* - `runningTotal`—The sum of point values since the last `"runningTotal"` summary point. Available for the Waterfall series.
* - `total`—The sum of all previous series values. Available for the Waterfall series.
*/
content?: (e: any) => string;
/**
* The font style of the labels.
*/
font?: string;
/**
* The format of the labels. Uses the [`format`](https://www.telerik.com/kendo-react-ui/components/intl/api/intlservice#toc-format) method of IntlService.
*/
format?: string;
/**
* The margin of the labels. A numeric value sets all margins.
*/
margin?: Margin | number;
/**
* The padding of the labels. A numeric value sets all margins.
*/
padding?: Padding | number;
/**
* If set to `true`, the Chart displays the series labels. By default, the Chart series labels are not displayed.
*/
visible?: boolean;
/**
* A function that can be used to create a custom visual for the labels.
*
* The available argument fields are:
* - `text`—The label text.
* - `rect`—The geometry [`Rect`](https://www.telerik.com/kendo-react-ui/components/drawing/api/geometry/rect) that defines where the visual has to be rendered.
* - `sender`—The Chart instance (might be `undefined`).
* - `options`—The label options.
* - `createVisual`—A function that can be used to get the default visual.
*/
visual?: (e: SeriesLabelsVisualArgs) => drawing.Element;
/**
* The Chart series `from` label configuration. The Chart displays the series labels when either the [`seriesDefaults.labels.visible`](https://www.telerik.com/kendo-react-ui/components/charts/api/chartseriesdefaultslabelsprops#toc-visible) or the [`seriesDefaults.labels.from.visible`](https://www.telerik.com/kendo-react-ui/components/charts/api/chartseriesdefaultslabelsfromprops#toc-visible) option is set to `true`.
*/
from?: SeriesDefaultsLabelsFrom;
/**
* The Chart series `to` label configuration. The Chart displays the series labels when either the [`seriesDefaults.labels.visible`](https://www.telerik.com/kendo-react-ui/components/charts/api/chartseriesdefaultslabelsprops#toc-visible) or the [`seriesDefaults.labels.to.visible`](https://www.telerik.com/kendo-react-ui/components/charts/api/chartseriesdefaultslabelstoprops#toc-visible) option is set to `true`.
*/
to?: SeriesDefaultsLabelsTo;
}