53 lines
1.5 KiB
Markdown
53 lines
1.5 KiB
Markdown
# 354 Playlist 播放列表
|
||
|
||
## 用途
|
||
|
||
播放列表：标出当前项，可拖动排序、移除，只构建可见行。
|
||
|
||
## 最小示例
|
||
|
||
```go
|
||
items := []mujica.PlaylistItem{{ID: "a", Title: "Overture"}, {ID: "b", Title: "Masquerade"}}
|
||
current := "a"
|
||
view := func(c *ui.Context) {
|
||
mujica.Use(c, mujica.Settings{})
|
||
if r := mujica.Playlist(c, &items, mujica.PlaylistOptions{Current: current}); r.Played != "" {
|
||
current = r.Played
|
||
}
|
||
}
|
||
ui.Render(view, 400, 300, 1)
|
||
```
|
||
|
||
## 参数
|
||
|
||
`func Playlist(c *ui.Context, items *[]PlaylistItem, opts PlaylistOptions) PlaylistResult`
|
||
|
||
`PlaylistItem`：`ID`（唯一且非空，否则 panic）、`Title`、`Subtitle`、`Duration`。组件直接修改 `*items` 完成排序和移除。
|
||
|
||
| 字段 | 类型 | 默认值 | 含义 |
|
||
| --- | --- | --- | --- |
|
||
| `Current` | `string` | "" | 正在播放项的 ID，显示播放标记和强调文字。 |
|
||
| `Height` | `float32` | 0（即 320） | 列表高度。 |
|
||
| `Disabled` | `bool` | false | 禁用选择、排序和移除。 |
|
||
|
||
## 状态
|
||
|
||
基于 List：选中行使用 Selection 底色加勾选标记；空列表显示提示。
|
||
|
||
## 事件
|
||
|
||
`PlaylistResult`：`Played` 为 Enter 或双击选择的 ID；`Removed` 为被移除的 ID；`Moved` 表示顺序变化。
|
||
|
||
## 键盘操作
|
||
|
||
| 按键 | 作用 |
|
||
| --- | --- |
|
||
| ↑ / ↓ | 移动选择 |
|
||
| Enter | 播放选中项 |
|
||
| Alt+↑ / Alt+↓ | 上移 / 下移选中项 |
|
||
| Delete / Backspace | 移除选中项 |
|
||
|
||
## 限制
|
||
|
||
- 拖动排序由 MyGo List 的 Reorder 提供，拖动时显示插入线。
|