44 lines
1.1 KiB
Markdown
44 lines
1.1 KiB
Markdown
# FileExplorer
|
||
|
||
## 用途
|
||
|
||
组合文件夹树、文件列表、导航历史与多选。
|
||
|
||
## 最小示例
|
||
|
||
```go
|
||
var state mujica.FileExplorerState
|
||
opts := mujica.FileExplorerOptions{
|
||
Roots: []string{"/court"},
|
||
Folders: func(string) []string { return nil },
|
||
Entries: func(string) []mujica.FileEntry {
|
||
return []mujica.FileEntry{{Path: "/court/seal.go", Name: "seal.go", Size: 1024}}
|
||
},
|
||
}
|
||
view := func(c *ui.Context) {
|
||
mujica.Use(c, mujica.Settings{})
|
||
mujica.FileExplorer(c, &state, opts).Element.Height(240)
|
||
}
|
||
ui.Render(view, 600, 300, 1)
|
||
```
|
||
|
||
## 参数
|
||
|
||
Roots、Folders、Entries 必填；Disabled 默认 false；Revision 用于原地更新条目。
|
||
|
||
## 状态
|
||
|
||
默认、焦点、禁用；空数据按组件内容展示。
|
||
|
||
## 事件
|
||
|
||
Navigated、Changed、Opened 返回本帧导航、选择和打开。
|
||
|
||
## 键盘操作
|
||
|
||
Tab 切换；方向键选择；Enter 打开；macOS Command+[ / ] / ↑，其他平台 Alt+← / → / ↑。
|
||
|
||
## 限制
|
||
|
||
文件及目录由调用方提供，读取与打开由调用方执行。条目 Path 必须唯一且非空；切片地址、长度或 Revision 变化时重建索引并清理已删除的选择。
|