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

XUI-File.png

results matching ""

    No results matching ""