049 FileDropZone

文件拖放区。

用途

接收从系统拖入或通过“浏览…”选择的文件，检查类型、数量和大小，显示文件列表与错误，可逐项移除。不上传，不读取内容。

最小示例

var files []input.DroppedFile
view := func(c *ui.Context) {
	core.Use(c, core.Settings{})
	input.FileDropZone(c, &files, input.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 的无窗口测试器不能模拟系统拖放，自动测试通过“浏览…”路径覆盖同一检查流程。