HOWTO · JavaScript
JavaScript를 사용하여 플러그인 없이 입력 텍스트 마스킹
플러그인 없이 브라우저 측 JavaScript 입력 마스크로 신용카드, 우편번호, 전화번호 입력을 입력하는 동안 서식을 지정하세요.
이 페이지의 내용
플러그인 없이도 JavaScript에서 input 이벤트 핸들러로 필드 값을 서식 지정하면 입력 마스크를 만들 수 있습니다. 아래 예제는 간단한 JavaScript 함수만 사용하므로 다운로드할 라이브러리 파일이 필요하지 않습니다. 신용 카드 숫자, 예시용 영숫자 우편번호, 북미 전화번호의 서식을 지정한 뒤 다른 필드에 맞게 포맷터를 조정하는 방법도 보여 줍니다.
예제를 사용하려면 해당 입력 요소 뒤에 있는 HTML <script> 요소에 스크립트를 넣거나 defer를 사용해 불러오세요. 입력 요소의 id는 스크립트에서 사용하는 값과 일치해야 합니다. 각 코드 샘플은 해당 필드에 사용할 수 있는 완전한 JavaScript 프로그램입니다. 여기서는 브라우저에서 스니펫을 실행하지 않았으므로 실행 결과를 제시하지 않습니다.
서식 지정은 입력하는 동안 화면에 표시되는 내용을 바꿉니다. 값이 유효한지 확인하거나 결제 카드를 식별하지 않으며, 서버 측 검사를 대신하지도 않습니다. HTML pattern은 양식 제출 시 완성된 값을 확인하는 데 도움이 될 수 있지만, 입력하는 동안 공백이나 문장 부호를 삽입하지는 않습니다.
JavaScript에서 신용 카드 번호 입력 마스크 적용하기
이 예제는 숫자만 남기고 네 자리마다 공백을 삽입합니다. 일반적인 카드 번호 길이를 지원하도록 최대 19자리까지 표시하며, 모든 카드 번호의 길이가 같다고 가정하지 않습니다. 숫자 문자열에 브라우저의 숫자 필드 동작이 적용되지 않도록 type="text"와 숫자 입력 힌트를 함께 사용합니다.
function formatCardNumber(value) {
const digits = value.replace(/\D/g, "").slice(0, 19);
return digits.replace(/(.{4})/g, "$1 ").trim();
}
if (typeof document !== "undefined") {
const cardField = document.querySelector("#card-number");
if (cardField) {
cardField.addEventListener("input", () => {
cardField.value = formatCardNumber(cardField.value);
});
}
}
<input id="card-number" type="text" inputmode="numeric" autocomplete="cc-number" placeholder="1234 5678 9012 3456">와 함께 사용하세요. 공백 없이 숫자를 입력하면 핸들러가 네 자리씩 묶어 공백을 넣습니다. 이 간단한 핸들러는 텍스트를 끝에 이어 입력할 때 가장 편리합니다. 키를 누를 때마다 값을 다시 서식 지정하면 중간 부분을 수정할 때 커서가 이동할 수 있으므로, 실제 결제 양식에는 커서 위치를 고려하는 충분히 검증된 포맷터를 사용하세요. 서식이 적용된 값은 표시용 입력으로 취급하고 별도로 검증해야 합니다.
JavaScript에서 우편번호 입력 마스크 적용하기
우편번호 형식은 국가마다 다르며, 일부 형식에는 문자와 공백 또는 하이픈이 사용됩니다. 이 예제는 문자와 숫자가 번갈아 나오는 여섯 글자 패턴을 보여 주는 것으로, 모든 지역에 통용되는 우편번호 규칙은 아닙니다. 문자는 대문자로 바꾸고 다른 문자는 제거하며 세 번째 문자 뒤에 공백을 표시합니다.
function formatPostalCode(value) {
const characters = value.toUpperCase().replace(/[^A-Z0-9]/g, "").slice(0, 6);
return characters.length > 3
? `${characters.slice(0, 3)} ${characters.slice(3)}`
: characters;
}
if (typeof document !== "undefined") {
const postalField = document.querySelector("#postal-code");
if (postalField) {
postalField.addEventListener("input", () => {
postalField.value = formatPostalCode(postalField.value);
});
}
}
<input id="postal-code" type="text" autocomplete="postal-code" placeholder="A1B 2C3">와 함께 사용하세요. 포맷터는 위치와 관계없이 문자와 숫자를 허용합니다. 플레이스홀더는 입력 형식의 예를 보여 주며, 함수는 문자에 서식만 적용합니다. 양식에서 지원하는 국가와 주소 데이터에 맞춰 허용 문자, 그룹 구분, 길이를 조정하세요. 다른 지역의 우편번호를 거부하는 데 이 예시 형식을 사용하지 마세요.
JavaScript에서 괄호를 사용하는 전화번호 입력 마스크 적용하기
다음 포맷터는 북미 국내 전화번호가 열 자리라고 가정하고 (212) 555-0123 형식으로 표시합니다. 숫자를 받아 추가 숫자는 버리며, 각 그룹의 숫자가 입력될 때 문장 부호를 넣습니다. 국가 번호, 내선 번호 또는 다른 국가의 번호 체계는 처리하지 않습니다.
function formatNorthAmericanPhone(value) {
const digits = value.replace(/\D/g, "").slice(0, 10);
if (digits.length === 0) return "";
if (digits.length < 4) return `(${digits}`;
if (digits.length < 7) return `(${digits.slice(0, 3)}) ${digits.slice(3)}`;
return `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
}
if (typeof document !== "undefined") {
const phoneField = document.querySelector("#phone-number");
if (phoneField) {
phoneField.addEventListener("input", () => {
phoneField.value = formatNorthAmericanPhone(phoneField.value);
});
}
}
스크립트를 <input id="phone-number" type="tel" autocomplete="tel-national" placeholder="(212) 555-0123">과 함께 사용하세요. 텍스트를 붙여 넣을 때도 input 이벤트가 발생하며, 포맷터는 붙여 넣은 내용에서 숫자만 남깁니다. 국제 전화 양식에서는 사용자가 선택한 국가에 맞는 형식을 정하거나 번호 체계와 커서 이동을 처리하는 전화번호 라이브러리를 사용하세요. 이 고정 형식의 예제는 일반적인 전화번호 입력 마스크가 아닙니다.
JavaScript에서 필드별 입력 마스크 사용자 지정하기
마스크를 다른 용도에 맞게 바꾸려면 서식 규칙과 필드의 플레이스홀더를 함께 수정해 같은 입력 형식을 나타내도록 하세요. 이 예제는 네 자리 부서 코드를 표시한 다음 하이픈과 숫자 두 자리를 덧붙입니다. 포맷터는 숫자만 허용하며 첫 번째 그룹이 완성되면 하이픈을 추가합니다.
function formatDepartmentCode(value) {
const digits = value.replace(/\D/g, "").slice(0, 6);
return digits.length > 4
? `${digits.slice(0, 4)}-${digits.slice(4)}`
: digits;
}
if (typeof document !== "undefined") {
const departmentField = document.querySelector("#department-code");
if (departmentField) {
departmentField.addEventListener("input", () => {
departmentField.value = formatDepartmentCode(departmentField.value);
});
}
}
이 규칙에는 <input id="department-code" type="text" inputmode="numeric" placeholder="1234-56">을 사용하세요. 다른 필드에 적용하려면 어떤 문자를 허용할지, 몇 자리까지 표시할지, 구분 기호를 어디에 둘지 정한 다음 플레이스홀더도 그에 맞게 바꾸세요. 플레이스홀더는 시각적인 안내일 뿐 서식 규칙은 아닙니다. 마찬가지로 HTML pattern은 제출된 문자열이 식과 일치하는지 확인하지만, 사용자가 입력하는 동안 문자를 삽입하지는 않습니다. 서식 지정 로직과 검증 로직을 분리하고, 양식의 실제 요구사항에 따라 완성된 값을 검증하세요.