마스킹된 텍스트

사용자는 지정된 형식을 준수해야 하는 텍스트를 입력해야 합니다. 예를 들어, 우편번호 또는 신용카드 번호입니다.

이 보기를 String 변수에 바인드할 수 있습니다. 또한 동작 및 모양 구성 특성을 정의할 수도 있습니다.

구성 특성

구성에서 보기의 모양 및 동작 특성을 설정하거나 수정하십시오.

화면 크기: 특성 이름 옆에 화면 크기 아이콘 이 있는 구성 특성은 각 화면 크기에 대해 다른 값을 가질 수 있습니다. 값을 설정하지 않을 경우 화면 크기는 다음으로 큰 화면 크기 값을 기본값으로 상속합니다.

테마 정의: 테마 정의는 보기를 위해 색상 및 스타일을 지정하고 보기의 모양을 결정합니다. 테마 편집기에서 보기의 룩앤필을 미리볼 수 있습니다. 테마를 참조하십시오.

마스크 텍스트 보기의 모양 구성 특성은 다음 테이블에 표시됩니다.

표 1. 마스크 텍스트의 모양 구성 특성
모양 구성 특성	설명	데이터 유형
모노스페이스	텍스트를 입력할 때 마스크가 이동되지 않도록 합니다.	`Boolean`
너비	뷰의 너비. 너비(px, 픽셀) 또는 em 단위를 지정할 수 있습니다. 예를 들면, 50px, 20% 또는 0.4em입니다. 단위 유형이 지정되지 않으면 px를 사용합니다.	`String`
크기 스타일	마스크 텍스트의 크기를 지정합니다.	`String`
레이블 배치	포함된 텍스트에 상대적인 레이블 배치를 지정합니다(맨 위 또는 왼쪽). 기본 레이블 배치는 맨 위입니다.	`String`
레이블 너비	레이블의 너비입니다. 너비(px, 픽셀) 또는 em 단위를 지정할 수 있습니다. 예를 들면, 50px, 20% 또는 0.4em입니다. 단위 유형이 지정되지 않으면 px를 사용합니다.	`String`

마스크 텍스트 보기의 동작 구성 특성은 다음 테이블에 나와 있습니다.

표 2. 마스크 텍스트의 동작 구성 특성
동작 구성 특성	설명	데이터 유형
탭 색인	필드를 통해 테이블 형식의 순서 색인을 정의합니다. 탭 색인은 1에서 시작합니다. 이를 드물게 추가할 수 있습니다 (예: `1`, `5`, `10`).	`Integer`
플레이스홀더 텍스트	값을 입력하지 않았을 때 표시되는 플레이스홀더 텍스트를 제공합니다. 대부분의 경우 이 플레이스홀더 텍스트는 마스크 텍스트와 동일합니다.	`String`
마스크	입력할 수 있는 문자 유형을 표시하려면 숫자 문자에 `#` 부호를 사용하고 알파벳 문자에 `a` 문자를 사용하십시오. 팁: 물음표 (?) 는 예약된 문자이며 물음표 뒤에 오는 문자는 선택사항입니다.	`String`
올바르지 않은 텍스트 자동 선택 취소	올바르지 않은 텍스트를 자동으로 제거하려면 이 옵션을 선택하십시오.	`Boolean`

전화번호에 대한 보기를 작성하려면 다음과 같이 구성 특성을 설정하십시오.

구성 창의 모양 파트에서 너비 를 200 px로, 크기 스타일 을 큰으로, 레이블 배치 를 맨 위로 설정하십시오.
동작 파트에서 사용자 위치 전화 걸기 규칙을 준수하는 허위 전화번호에 플레이스홀더 텍스트를 설정하고(예: (555) 555 - 5555) 마스크 필드에서 동일한 패턴에 # 문자의 문자열을 입력하십시오(예: (###) ### - ####).
기타 옵션은 비워두십시오.

상태 값에 대한 보기를 작성하려면 다음과 같이 구성 특성을 설정하십시오.

이벤트 탭에서 보기의 이벤트 핸들러를 설정하거나 수정하십시오. 사용자가 보기로 상호작용할 때 또는 프로그래밍 방식으로 트리거되도록 이벤트를 설정할 수 있습니다. 이벤트를 정의하고 코딩하는 방법에 대한 정보는 사용자 정의 이벤트를 참조하십시오.

마스크 텍스트 보기의 경우 다음 유형의 이벤트 핸들러를 활성화할 수 있습니다.

On load 페이지가 로드될 때 (예: me.setMask(${CountryCodeData}.getValue() == "uk" ? "(###) ####-####" : (###) ###-####) )
On change 보기의 데이터가 수정되는 경우 (예: me.setValid(@validNumber(newText),"Please enter a valid phone number") )
On focus 보기가 초점을 가져오는 경우 (예: me.setSizeStyle("L") )
On blur 사용자가 보기에서 클릭하거나 탭을 사용하여 제거하는 경우 (예: me.setSizeStyle("D") )
On input 사용자가 보기에 데이터를 입력하는 경우 (예: return potential.substr(0,3) != "555" )

사용 가능한 메소드에 대한 자세한 정보는 마스크된 텍스트 JavaScript API 를 참조하십시오.

Coach 또는 페이지를 작성하는 방법에 대한 정보는 Coach 빌드를 참조하십시오.
표준 특성 (일반, 구성, 위치 지정, 가시성및 HTML 속성) 에 대한 정보는 특성 보기를 참조하십시오.