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