TextField 한 줄 텍스트 필드

이 컴포넌트는 화면에 문자열 입력용 텍스트 필드를 표시합니다.

키	유형	설명	필수	기본값	최소 버전
alignment	문자열	정렬 방식	-	`Left`	-
keyboard	문자열	키보드 유형	-	`Default`	-
placeholder	문자열	텍스트 필드 자리표시자	현지화 가능	`""`	-
isSecure	불리언	문자를 작은 점으로 표시할지 여부	-	`false`	-
clearButtonMode	문자열	작은 검은색 십자 모양의 지우기 버튼을 표시할지 여부	-	`Never`	-
maxLength	정수	최대 텍스트 길이	-	`INT_MAX`	-
validationRegex	문자열	문자열 항목을 검증하는 정규 표현식	-	`nil`	1.2-10
prompt	문자열	입력 대화 상자 제목	현지화 가능	`nil`	1.2-10
message	문자열	입력 대화 상자 메시지	현지화 가능	`nil`	1.2-10
okTitle	문자열	입력 대화 상자 확인 버튼 제목	현지화 가능	`"好"`	1.2-10
cancelTitle	문자열	입력 대화 상자 취소 버튼 제목	현지화 가능	`"取消"`	1.2-10

이 컴포넌트는 icon을 지원하지 않습니다. title 속성을 설정했다면 alignment 속성을 "Right"로 설정하는 것이 좋습니다.

문자열 항목을 수정하거나 추가할 때 문자열이 정규 표현식 validationRegex 검증을 통과하지 못하면 현재 항목을 저장할 수 없습니다.

prompt 또는 message가 비어 있지 않으면 TextField를 탭할 때 입력 대화 상자가 나타나며, 대화 상자에 값을 입력해야 합니다.

alignment	설명
Left	왼쪽 정렬
Center	가운데 정렬
Right	오른쪽 정렬
Natural	자연 정렬
Justified	양쪽 맞춤

keyboard	설명
Default	표준 및 타사 키보드
Alphabet	표준 ASCII
ASCIICapable	표준 ASCII
NumbersAndPunctuation	숫자 및 문장 부호
URL	웹 주소
NumberPad	숫자 키패드
PhonePad	전화번호
NamePhonePad	이름 및 전화번호
EmailAddress	이메일
DecimalPad	소수점이 있는 숫자

clearButtonMode	설명
Never	표시 안 함
Always	항상 표시
WhileEditing	편집 중에만 표시
UnlessEditing	편집 중이 아닐 때만 표시

반환 유형	설명
문자열	텍스트 필드 내용

테마

테마 키	유형	설명
textColor	색상	텍스트 색상
caretColor	색상	커서 색상
placeholderColor	색상	자리표시자 색상

예제

{
    default = "";
    label = "用户名";
    cell = "TextField";
    key = "username";
    keyboard = "Default";  -- 기본 키보드
    alignment = "Right";  -- 오른쪽 정렬
    placeholder = "输入用户名";  -- 자리표시자
    maxLength = 21;  -- 최대 길이
    validationRegex = "^[0-9a-zA-Z]+$";  -- 정규 표현식 검증
};
{
    isSecure = true;  -- 작은 점으로 표시되는 비밀번호 입력
    default = "";
    label = "密码";
    cell = "TextField";
    key = "password";
    keyboard = "NumberPad";  -- 숫자 키패드
    alignment = "Right";  -- 오른쪽 정렬
    placeholder = "输入密码";  -- 자리표시자
    prompt = "请输入密码";  -- 대화 상자 제목
    message = "请在提示框中输入 6 位数字密码";  -- 대화 상자 메시지
    validationRegex = "^[0-9]{6}$";  -- 정규 표현식 검증
    okTitle = "保存";  -- 제출 버튼 제목
    cancelTitle = "取消";  -- 취소 버튼 제목
};

테마

예제​

예제