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" };  -- 이 확장자의 파일만 선택 허용
};

테마

예제​

예제