39 lines
1.2 KiB
Markdown
39 lines
1.2 KiB
Markdown
# 121 ChartLegend 图例
|
||
|
||
## 用途
|
||
|
||
展示序列名称与形状；点击或键盘切换序列显隐，支持横纵布局和折叠。
|
||
|
||
## 最小示例
|
||
|
||
```go
|
||
hidden := map[string]bool{}
|
||
view := func(c *ui.Context) {
|
||
mujica.Use(c, mujica.Settings{})
|
||
k := mujica.Tokens(c)
|
||
items := []mujica.ChartLegendItem{{Name: "Pews", Color: k.Info}, {Name: "Candles", Color: k.Success, Shape: 1}}
|
||
mujica.ChartLegend(c, &hidden, items, mujica.ChartLegendOptions{MaxItems: 1})
|
||
}
|
||
ui.Render(view, 400, 200, 1)
|
||
```
|
||
|
||
## 参数
|
||
|
||
`hidden *map[string]bool`：名称映射到隐藏状态，nil 为静态图例。`items []ChartLegendItem`：唯一非空 `Name`、`Color`、`Shape`（0–4）。`Vertical` 默认 false；`MaxItems` 默认 0，显示全部，负值 panic。
|
||
|
||
## 状态
|
||
|
||
可见项显示形状，隐藏项显示空框与删除线；支持祖先禁用。折叠后显示展开按钮。
|
||
|
||
## 事件
|
||
|
||
`Toggled()` 返回本帧切换的序列名称和是否发生事件。
|
||
|
||
## 键盘操作
|
||
|
||
Tab 进入图例；方向键在项之间移动；Space 切换显隐；展开按钮支持 Enter 和 Space。
|
||
|
||
## 限制
|
||
|
||
调用方依据 hidden 控制数据序列。图例颜色来自调用方，应使用主题色；形状提供颜色之外的识别。
|