MujicaUI

Navigation · #060

SegmentedControl 浅色主题渲染快照
浅色 · 渲染快照
SegmentedControl 深色主题渲染快照
深色 · 渲染快照

060 SegmentedControl 分段控件

用途

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

最小示例

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

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

参数

selected:当前分段下标;越界时 panic。segments 为空时 panic。

Segment

字段类型默认值含义
Labelstring必填分段文字与无障碍名称;为空时 panic。
Icon*ui.SVGnil文字前的图标。
HideLabelboolfalse只显示图标,Label 作为名称与提示文字;没有 Icon 时 panic。

SegmentedControlOptions

字段类型默认值含义
Equalboolfalse所有分段等宽(取最宽者);否则按内容自适应。
Labelstring""单选组的无障碍名称。
Disabledboolfalse整组禁用。

状态

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

事件

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

键盘操作

  • Tab:进入控件,落在当前分段(一个 Tab 停靠点)。
  • 方向键:选择上一个/下一个分段并循环;Home / End 到两端。

限制

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