MujicaUI/docs/components/354-playlist.md

354 Playlist 播放列表

用途

播放列表：标出当前项，可拖动排序、移除，只构建可见行。

最小示例

items := []media.PlaylistItem{{ID: "a", Title: "Overture"}, {ID: "b", Title: "Masquerade"}}
current := "a"
view := func(c *ui.Context) {
	core.Use(c, core.Settings{})
	if r := media.Playlist(c, &items, media.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 提供，拖动时显示插入线。