InputMask 개요
InputMask 컨트롤을 통해 입력되는 사용자 입력의 유효성을 검사하고 형식을 지정할 수 있습니다. 이 컨트롤은 사용자가 실수로 잘못된 데이터를 입력하는 것을 방지하고 사용자가 입력할 때 리터럴(예: 날짜의 슬래시)을 건너뛰어 시간을 절약합니다.
입력의 유효성을 확인하는 데 사용되는 마스크는 mask 속성으로 정의되며, 여기에는 다음 특수 문자 중 하나 이상이 포함될 수 있습니다:
Character | Mask Type |
|---|---|
0 | 숫자. |
9 | 숫자 또는 공백. |
# | 숫자, 기호 또는 공백. |
L | 문자. |
l | 문자 또는 공백. |
A | 영숫자 |
a | 영숫자 또는 공백. |
. | 현지화 된(Localized) 소수점. |
, | 현지화 된(Localized) 천 단위 구분 기호. |
: | 현지화 된(Localized) 시간 구분 기호. |
/ | 현지화 된(Localized) 날짜 구분 기호. |
$ | 현지화 된(Localized) 통화 기호. |
< | 뒤에 오는 문자를 소문자로 변환. |
> | 뒤에 오는 문자를 대문자로 변환. |
\ | 모든 문자를 이스케이프하여 리터럴로 바꿈. |
9 | DBCS 숫자. |
J | DBCS 히라가나. |
G | DBCS 큰 히라가나. |
K | DBCS 가타카나. |
N | DBCS 큰 가타카나. |
K | SBCS 가타카나. |
N | SBCS 큰 가타카나. |
Z | 임의의 DBCS 문자 |
H | 임의의 SBCS 문자. |
All others | 리터럴 |
컨트롤의 주요 속성은 다음과 같습니다:
value: 사용자 입력과 템플릿 문자를 포함하여 컨트롤의 전체 텍스트 콘텐츠를 반환합니다.
rawValue: value 속성과는 달리, rawValue 속성을 통해 입력 문자만 포함하고 템플릿 문자는 제외한 컨트롤 값을 가져오거나 설정할 수 있습니다.
promptChar: 기본적으로, InputMask 컨트롤은 밑줄 문자를 사용하여 입력이 예상되는 위치를 나타냅니다. promptChar 속성에 새 문자열을 할당하여 이를 변경할 수 있습니다. 예시는 프롬프트 문자 데모를 참고하시길 바랍니다.
maskFull: 마스크가 완전히 채워졌는지의 여부를 나타냅니다. 예시는 InputMask 유효성 검사 데모를 참고하시길 바랍니다.
HTML
<input id="thePhone"><br>Javascript
import * as input from '@mescius/wijmo.input';
function init() {
let thePhone = new input.InputMask('#thePhone', {
mask: '(999) 000-0000'
});
}