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