跳到内容

ChartsLegendAPI

React ChartsLegend 组件的 API 参考文档。了解此导出模块的 props、CSS 和其他 API。

演示

导入

import { ChartsLegend } from '@mui/x-charts/ChartsLegend';
// or
import { ChartsLegend } from '@mui/x-charts';
// or
import { ChartsLegend } from '@mui/x-charts-pro';

通过阅读这篇关于最小化 bundle size 的指南,了解它们之间的区别。

Props

名称类型默认描述
classesobject-

覆盖或扩展应用于组件的样式。

有关更多详细信息,请参阅下面的CSS 类 API

direction'column'
| 'row'
-

图例布局的方向。默认值取决于图表。

hiddenboolfalse

设置为 true 以隐藏图例。

itemGapnumber10

两个图例项目之间的间距(以像素为单位)。

itemMarkHeightnumber20

项目标记的高度(以像素为单位)。

itemMarkWidthnumber20

项目标记的宽度(以像素为单位)。

labelStyleobjecttheme.typography.subtitle1

应用于图例标签的样式。

markGapnumber5

标记和标签之间的间距(以像素为单位)。

onItemClickfunc-

单击图例项目时触发的回调。

签名:function(event: React.MouseEvent, legendItem: SeriesLegendItemContext, index: number) => void
  • event 点击事件。
  • legendItem 图例项目数据。
  • index 被点击的图例项目的索引。
paddingnumber
| { bottom?: number, left?: number, right?: number, top?: number }
10

图例内边距(以像素为单位)。可以是单个数字,也可以是具有 top、left、bottom、right 属性的对象。

position{ horizontal: 'left'
| 'middle'
| 'right', vertical: 'bottom'
| 'middle'
| 'top' }
-

图例的位置。

slotPropsobject{}

用于每个组件插槽的 props。

slotsobject{}

可覆盖的组件插槽。

有关更多详细信息,请参阅下面的插槽 API

该组件不能持有 ref。

插槽

插槽名称类名默认组件描述
legendDefaultChartsLegend图例的自定义渲染。

CSS 类

这些类名对于使用 CSS 设置样式很有用。当触发特定状态时,它们将应用于组件的插槽。

类名规则名称描述
.MuiChartsLegend-columncolumn应用于具有列布局的图例的样式。
.MuiChartsLegend-itemBackgrounditemBackground应用于项目背景的样式。
.MuiChartsLegend-labellabel应用于系列标签的样式。
.MuiChartsLegend-markmark应用于系列标记元素的样式。
.MuiChartsLegend-rootroot应用于根元素的样式。
.MuiChartsLegend-rowrow应用于具有行布局的图例的样式。
.MuiChartsLegend-seriesseries应用于系列元素的样式。

您可以使用以下自定义选项之一来覆盖组件的样式

源代码

如果您在此页面中找不到所需的信息,请考虑查看组件的实现以获取更多详细信息。