MujicaUI/docs/components/060-segmented-control.md

060 SegmentedControl 分段控件

用途

在少量互斥选项之间切换视图或范围，如“日 / 周 / 月”或“列表 / 网格”。基于 MyGo SegmentedBase，辅助技术看到单选组。

最小示例

mujica.SegmentedControl(c, &view, []mujica.Segment{
	{Label: "List", Icon: icons.Must("list"), HideLabel: true},
	{Label: "Grid", Icon: icons.Must("layout-grid"), HideLabel: true},
}, mujica.SegmentedControlOptions{Label: "View"})

签名：func SegmentedControl(c *ui.Context, selected *int, segments []Segment, opts SegmentedControlOptions) *ui.Element

参数

selected：当前分段下标；越界时 panic。segments 为空时 panic。

Segment

字段	类型	默认值	含义
Label	string	必填	分段文字与无障碍名称；为空时 panic。
Icon	*ui.SVG	nil	文字前的图标。
HideLabel	bool	false	只显示图标，Label 作为名称与提示文字；没有 Icon 时 panic。

SegmentedControlOptions

字段	类型	默认值	含义
Equal	bool	false	所有分段等宽（取最宽者）；否则按内容自适应。
Label	string	""	单选组的无障碍名称。
Disabled	bool	false	整组禁用。

状态

• 选中：Accent 填充、OnAccent 文字、600 字重。
• 悬停 SurfaceHover，按下 Selection；焦点环 2 DIP。
• 禁用：整组降低不透明度，点击与方向键不改变值。

事件

• 返回元素的 Changed()：本帧用户选择了新分段。

键盘操作

• Tab：进入控件，落在当前分段（一个 Tab 停靠点）。
• 方向键：选择上一个/下一个分段并循环；Home / End 到两端。

限制

• 不支持单个分段禁用：MyGo SegmentedBase 的焦点组在方向键移动时直接点击目标分段。