File 文件选择器
此组件在界面上显示文件选择区域, 可显示文件类型图标、文件名称与文件修改时间, 点击可选择新文件. 通常用于选择数据文件, 提供路径给服务脚本使用.
| 键 | 类型 | 描述 | 必选 | 默认值 | 最低版本需求 |
|---|---|---|---|---|---|
| initialPath | 字符串 | 文件选择初始顶层目录 | - | XPP 根路径 | - |
| allowedExtensions | 包含字符串的数组 | 允许的文件扩展名列表 | - | [] |
- |
| label | 字符串 | 未选择文件时的提示标题 | 可本地化 | "" |
1.2-10 |
| footerText | 字符串 | 未选择文件时的提示信息 | 可本地化 | "" |
1.2-10 |
| isFile | 布尔型 | 是否选择文件, 如果为 false 则选择目录 |
- | true |
1.2-10 |
此组件可以左划会显示删除按钮, 轻按删除按钮可将已存的配置值置空.
initialPath 是相对于 XPP 脚本包的相对路径. 若不填, 则为当前脚本包路径.
allowedExtensions 中包含允许选择的文件名列表, 不符合扩展名要求的项目将不会被显示, 更无法被选择.
| 返回类型 | 描述 |
|---|---|
| 字符串 | 所选文件完整绝对路径 |
主题
| 主题键 | 类型 | 描述 |
|---|---|---|
| labelColor | 颜色 | 文件名颜色 |
| valueColor | 颜色 | 文件描述颜色 |
示例
{
cell = "File";
key = "file1";
initialPath = "scripts";
isFile = true; -- 选择文件
label = "请选择一个脚本"; -- 标题
-- footerText = "可选择所有 XXT 支持的脚本格式"; -- 描述
allowedExtensions = { "lua"; "xxt"; "xpp" }; -- 只允许选择这些扩展名的文件
};
