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" };  -- 只允许选择这些扩展名的文件
};
