ZacharyZhang-NY
8880865021
Every component result type now names its element Element instead of embedding *ui.Element. The eleven element-plus-changed results (AccordionView, CarouselView, CollapsibleView, ImageViewerView, PaginationResult, StepsResult, SidebarResult, TabsResult, RatingParts, FileDropZoneParts, TransferParts) fold into ChoiceResult. Fixes four Gallery demos where .Width(...).Changed() read the element's flag instead of the component's: Accordion, MultiSelect, Cascader, TreeSelect. TestDataAccordionDemoLogsChange covers the Accordion.
2.3 KiB
2.3 KiB
061 Breadcrumb 面包屑
用途
显示当前位置的层级路径。最后一项为当前页（非链接），前面各项可点击返回；层级过多时中间项折叠到“…”菜单；过长名称以省略号截断，悬停显示完整名称。
最小示例
if i, ok := mujica.Breadcrumb(c, path, mujica.BreadcrumbOptions{}).Chosen(); ok {
path = path[:i+1]
}
签名：func Breadcrumb(c *ui.Context, items []BreadcrumbItem, opts BreadcrumbOptions) BreadcrumbResult
参数
items 为空时 panic。
BreadcrumbItem
| 字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
Label |
string |
必填 | 名称；为空时 panic。 |
Icon |
*ui.SVG |
nil | 名称前的 14 DIP 图标。 |
BreadcrumbOptions
| 字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
MaxItems |
int |
0（即 4） | 最多显示的项数；超出时保留第一项和最后 MaxItems-2 项，其余折叠。小于 3 时 panic。 |
MaxItemWidth |
float32 |
0（即 160 DIP） | 单项文字最大宽度，超出以省略号截断。 |
Label |
string |
内置“路径导航” | 整组的无障碍名称。 |
返回 BreadcrumbResult，Element 字段是组件元素。
状态
- 链接：TextMuted 文字，悬停 SurfaceHover 背景与 Text 文字，焦点环 2 DIP。
- 当前项：Text 文字、600 字重，无障碍名称附“当前页”。
- 分隔：旧金（Ornament）小箭头，不进入无障碍树。
- 折叠按钮“…”：打开弹层列出被折叠的项，弹层打开时焦点在第一项。
事件
Chosen() (int, bool)：本帧被激活的项下标（含折叠菜单中的项）。组件不修改路径，由调用方处理。
键盘操作
- Tab / Shift+Tab：在各链接与折叠按钮之间移动；Enter 或 Space 激活。
- 折叠菜单：Tab 在项之间移动，Enter 选择，Escape 关闭并把焦点还给“…”按钮。
限制
- 完整名称提示对每一项都提供，MyGo 不报告文字是否被截断。
- 未复用 MyGo
ui.Breadcrumbs：它不支持折叠与提示，本组件用ButtonBase、PopoverBase组合实现。 - 弹层打开时在 160 ms 内淡入，减少动画时直接显示。关闭时立即消失：弹层关闭后 MyGo 不再构建其元素，公开接口无法为已移除的浮层做淡出。