MujicaUI/docs/components/048-file-picker.md

048 FilePicker

文件选择。

用途

调用 MyGo 的系统文件或文件夹选择对话框（mygo.Dialog.Open），支持单选、多选与扩展名筛选，只返回所选路径。

最小示例

var paths []string
view := func(c *ui.Context) {
	mujica.Use(c, mujica.Settings{})
	mujica.FilePicker(c, &paths, mujica.FilePickerOptions{
		Multiple: true,
		Filters:  []mygo.FileFilter{{Name: "Scores", Extensions: []string{"pdf", "mid"}}},
	})
}
ui.Render(view, 400, 300, 1)

参数

字段	类型	默认值	含义
paths	*[]string	必填	所选路径；取消时不变。
Directory	bool	false	选择文件夹。
Multiple	bool	false	允许多选。
Filters	[]mygo.FileFilter	nil	扩展名筛选，扩展名不带点；带点时 panic。
Title	string	""	对话框标题。
Label	string	内置“Choose file…/选择文件…”	按钮文字。
Parent	*mygo.Window	nil	附着的窗口（macOS 显示为表单）。
Disabled	bool	false	禁用。

状态

默认、对话框打开中（按钮显示加载并阻止重复打开）、已选择（列出文件名与所在目录）、对话框失败（危险色说明）、禁用。

事件

FilePickerParts.Changed() 选中了新路径；Canceled() 用户取消，不视为错误。

键盘操作

Enter/Space 打开系统对话框；对话框内的键盘操作由系统提供。

限制

• 对话框为系统样式，不换肤。
• 对话框在后台 goroutine 中等待，结果经 Context.Invalidate 回到界面线程；需要应用已通过 mygo.App.Run 启动，无窗口测试中无法打开真实对话框。
• 不读取文件内容。