File — выбор файла
Компонент отображает область выбора файла со значком типа файла, именем и временем изменения. Нажатие позволяет выбрать новый файл. Обычно компонент используется для выбора файла данных и передачи его пути сервисному скрипту.
| Ключ | Тип | Описание | Обязателен | Значение по умолчанию | Минимальная версия |
|---|---|---|---|---|---|
| initialPath | string | Исходный верхний каталог выбора файла | - | Корень XPP | - |
| allowedExtensions | массив строк | Список разрешённых расширений файлов | - | [] | - |
| label | string | Заголовок подсказки, если файл не выбран | локализуемый | "" | 1.2-10 |
| footerText | string | Текст подсказки, если файл не выбран | локализуемый | "" | 1.2-10 |
| isFile | boolean | Выбирать файл; если false, выбирается каталог | - | true | 1.2-10 |
Проведите по компоненту влево, чтобы показать кнопку удаления; лёгкое нажатие этой кнопки очистит сохранённое значение настройки.
initialPath — относительный путь от пакета скриптов XPP. Если не задан, используется путь текущего пакета скриптов.
allowedExtensions содержит список разрешённых расширений файлов. Элементы с другими расширениями не отображаются и не могут быть выбраны.
| Тип возвращаемого значения | Описание |
|---|---|
| string | Полный абсолютный путь к выбранному файлу |
Тема
| Ключ темы | Тип | Описание |
|---|---|---|
| labelColor | color | Цвет имени файла |
| valueColor | color | Цвет описания файла |
Пример
{
cell = "File";
key = "file1";
initialPath = "scripts";
isFile = true; -- Выбирать файл
label = "请选择一个脚本"; -- Заголовок
-- footerText = "可选择所有 XXT 支持的脚本格式"; -- Описание
allowedExtensions = { "lua"; "xxt"; "xpp" }; -- Разрешить только файлы с этими расширениями
};
