@progress/kendo-angular-charts
Version:
Kendo UI Charts for Angular - A comprehensive package for creating beautiful and interactive data visualization. Every chart type, stock charts, and sparklines are included.
127 lines (126 loc) • 5.92 kB
TypeScript
/**-----------------------------------------------------------------------------------------
* Copyright © 2025 Progress Software Corporation. All rights reserved.
* Licensed under commercial license. See LICENSE.md in the project root for more information
*-------------------------------------------------------------------------------------------*/
import { ConfigurationService } from '../common/configuration.service';
import { SettingsComponent } from '../common/settings.component';
import { Border, LegendLabels, Margin, Padding, LegendMarkers, LegendInactiveItems, LegendItem, Legend, LegendTitle, FocusHighlight } from '../common/property-types';
import * as i0 from "@angular/core";
/**
* Represents the Kendo UI for Angular Chart Legend configuration
* ([see example]({% slug legend_chart_charts %})).
*
* @example
* ```html
* <kendo-chart>
* <kendo-chart-legend position="top" [visible]="true">
* </kendo-chart-legend>
* </kendo-chart>
* ```
*
* @remarks
* Supported children components are: {@link LegendInactiveItemsComponent} and {@link LegendItemComponent}.
*/
export declare class LegendComponent extends SettingsComponent implements Legend {
configurationService: ConfigurationService;
/**
* Specifies the alignment of the legend.
* The legend is horizontally aligned when [`legend.position`]({% slug api_charts_legend %}#toc-position) is set to `"top"` or `"bottom"`.
* The legend is vertically aligned when [`legend.position`]({% slug api_charts_legend %}#toc-position) is set to `"left"` or `"right"`.
* @default 'center'
*/
align: 'start' | 'center' | 'end';
/**
* Specifies the background color of the legend. Accepts a valid CSS color string, including hex and rgb.
* @default 'white'
*/
background: string;
/**
* Specifies the border configuration of the legend.
*/
border: Border;
/**
* Specifies the height of the legend.
*/
height: number;
/**
* Specifies the labels configuration of the legend.
*/
labels: LegendLabels;
/**
* Specifies the margin of the Chart legend. A numeric value sets all paddings.
* @default 5
*/
margin: Margin | number;
/**
* Specifies the X offset of the Chart legend. The offset is relative to the default position of the legend.
* For example, a value of `20` moves the legend 20 pixels to the right of its initial position.
* Negative values move the legend to the left of its current position.
* @default 0
*/
offsetX: number;
/**
* Specifies the Y offset of the chart legend. The offset is relative to the current position of the legend.
* For example, a value of `20` moves the legend 20 pixels down from its initial position.
* Negative values move the legend upwards from its current position.
* @default 0
*/
offsetY: number;
/**
* Specifies the orientation of the legend items.
* @default 'vertical'
*/
orientation: 'vertical' | 'horizontal';
/**
* Specifies the padding of the Chart legend. A numeric value sets all paddings.
* @default 5
*/
padding: Padding | number;
/**
* Specifies the positions of the Chart legend.
* Setting the legend position to `custom` allows you to position the legend using the [`legend.offsetX`](slug:api_charts_legend#toc-offsetx) and [`legend.offsetY`](slug:api_charts_legend#toc-offsety) options.
* @default 'right'
*/
position: 'top' | 'bottom' | 'left' | 'right' | 'custom';
/**
* Determines whether the legend items are reversed.
* @default false
*/
reverse: boolean;
/**
* Determines whether the Chart displays the legend. By default, the Chart legend is visible.
* @default true
*/
visible: boolean;
/**
* Specifies the width of the legend.
*/
width: number;
/**
* Specifies the markers configuration of the legend.
*/
markers: LegendMarkers;
/**
* Specifies the spacing between legend items.
*/
spacing: number;
/**
* Specifies the inactive items configuration of the legend.
*/
inactiveItems: LegendInactiveItems;
/**
* Specifies the item configuration of the legend.
*/
item: LegendItem;
/**
* Specifies the title configuration of the legend.
*/
title: LegendTitle;
/**
* Specifies the focus highlight configuration of the legend.
*/
focusHighlight?: FocusHighlight;
constructor(configurationService: ConfigurationService);
static ɵfac: i0.ɵɵFactoryDeclaration<LegendComponent, never>;
static ɵcmp: i0.ɵɵComponentDeclaration<LegendComponent, "kendo-chart-legend", never, { "align": { "alias": "align"; "required": false; }; "background": { "alias": "background"; "required": false; }; "border": { "alias": "border"; "required": false; }; "height": { "alias": "height"; "required": false; }; "labels": { "alias": "labels"; "required": false; }; "margin": { "alias": "margin"; "required": false; }; "offsetX": { "alias": "offsetX"; "required": false; }; "offsetY": { "alias": "offsetY"; "required": false; }; "orientation": { "alias": "orientation"; "required": false; }; "padding": { "alias": "padding"; "required": false; }; "position": { "alias": "position"; "required": false; }; "reverse": { "alias": "reverse"; "required": false; }; "visible": { "alias": "visible"; "required": false; }; "width": { "alias": "width"; "required": false; }; "markers": { "alias": "markers"; "required": false; }; "spacing": { "alias": "spacing"; "required": false; }; "inactiveItems": { "alias": "inactiveItems"; "required": false; }; "item": { "alias": "item"; "required": false; }; "title": { "alias": "title"; "required": false; }; "focusHighlight": { "alias": "focusHighlight"; "required": false; }; }, {}, never, never, true, never>;
}