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.
1.6 KiB
1.6 KiB
050 Transfer
穿梭框。
用途
在左右两个列表间移动条目，选出一个子集。两侧各有搜索、复选与全选，中间按钮批量移动。以稳定 ID 保存状态。
最小示例
chosen := []string{"uika"}
items := []mujica.TransferItem{{ID: "uika", Label: "Uika"}, {ID: "mutsumi", Label: "Mutsumi"}, {ID: "nyamu", Label: "Nyamu", Disabled: true}}
view := func(c *ui.Context) {
mujica.Use(c, mujica.Settings{})
mujica.Transfer(c, &chosen, items, mujica.TransferOptions{})
}
ui.Render(view, 400, 300, 1)
参数
| 字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
target |
*[]string |
必填 | 右侧已选条目的 ID，按加入顺序；含未知 ID 时 panic。 |
items |
[]TransferItem |
必填 | 全部条目：ID（唯一、非空）、Label、Disabled。 |
SourceTitle / TargetTitle |
string |
内置“Available/可选”“Chosen/已选” | 两侧标题。 |
Height |
float32 |
240 | 列表高度（DIP）。 |
Disabled |
bool |
false | 禁用整个组件。 |
状态
默认、悬停、勾选（底色加勾选标记）、半选（全选框显示减号）、禁用条目（不可勾选、不随全选移动）、空列表、无搜索结果、禁用。
事件
ChoiceResult.Changed() 有条目移动。
键盘操作
Tab 进入列表，↑/↓ 在条目间移动，Space 勾选；Tab 到达全选框、搜索框与移动按钮。
限制
- 条目逐项创建，适合数百条以内；大数据量请使用虚拟化列表组合。
- 全选只作用于当前搜索结果中的可用条目。