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.8 KiB
1.8 KiB
049 FileDropZone
文件拖放区。
用途
接收从系统拖入或通过“浏览…”选择的文件，检查类型、数量和大小，显示文件列表与错误，可逐项移除。不上传，不读取内容。
最小示例
var files []mujica.DroppedFile
view := func(c *ui.Context) {
mujica.Use(c, mujica.Settings{})
mujica.FileDropZone(c, &files, mujica.FileDropZoneOptions{
Extensions: []string{"png", "jpg"}, MaxFiles: 3, MaxSize: 5 << 20,
})
}
ui.Render(view, 400, 300, 1)
参数
| 字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
files |
*[]DroppedFile |
必填 | 已接受的文件（Path、Size）。 |
Extensions |
[]string |
nil（不限） | 允许的扩展名，不带点，不区分大小写。 |
MaxFiles |
int |
0（不限） | 列表最多文件数。 |
MaxSize |
int64 |
0（不限） | 单个文件的最大字节数。 |
Hint |
string |
内置“Drop files here/将文件拖到此处” | 提示文字。 |
Disabled |
bool |
false | 禁用拖放、浏览与移除。 |
状态
默认、文件拖到上方（选中底色与强调色虚线边框）、检查中（列表显示“Checking…”）、已接受、被拒绝（危险色图标与具体原因）、禁用。
事件
ChoiceResult.Changed() 添加或移除了文件。被拒绝的条目只显示在组件内，可单独关闭。
键盘操作
Tab 到达“浏览…”与每个移除按钮；拖放需要指针，键盘用户通过“浏览…”添加文件。
限制
- 文件大小通过后台 goroutine 中的
os.Stat获取，不阻塞界面线程；文件夹、无法读取的路径会被拒绝。 - 重复路径静默忽略。
- MyGo 的无窗口测试器不能模拟系统拖放，自动测试通过“浏览…”路径覆盖同一检查流程。