MujicaUI/docs/components/498-dock-panel.md

498 DockPanel 停靠面板

用途

左、中、右、下四个停靠区，每区以标签页显示面板；把标签拖到区域或窗口边缘即停靠到那里。布局由调用方保存。

最小示例

var layout mujica.DockLayout
view := func(c *ui.Context) {
	mujica.Use(c, mujica.Settings{})
	r := mujica.DockPanel(c, &layout, []mujica.DockItem{
		{ID: "files", Title: "Files", Build: func() { ui.Text(c, "Files") }},
		{ID: "terminal", Title: "Terminal", Build: func() { ui.Text(c, "$") }},
	}, mujica.DockPanelOptions{})
	if r.Changed() {
		// save layout
	}
}

签名：func DockPanel(c *ui.Context, layout *DockLayout, items []DockItem, opts DockPanelOptions) ChoiceResult

参数

字段	类型	默认值	含义
layout	*DockLayout	全部在中央	各区面板 ID 与当前标签；未知或重复 ID panic。
items	[]DockItem	必填	ID、Title、Build；ID 重复 panic。
Disabled	bool	false	不可切换与停靠。

状态

拖动时四边出现停靠条，悬停的目标显示选中底色与强调边框；当前标签有下划线与选中底色。

事件

Changed()：布局变化（停靠或切换标签），用于保存。

键盘操作

每区标签是一个 Tab 停靠点，左右键切换；在标签上按 Shift+Alt+←/→/↓ 停靠到左、右、下，Shift+Alt+↑ 回到中央，焦点跟随标签。

限制

区域尺寸固定（侧栏 220 DIP，底部 160 DIP）；需要调整时与 ResizablePanelGroup 组合。