HTML attribute: maxlength

maxlength 특성은 유저가 <input> (en-US) 요소나 <textarea> (en-US) 요소에 입력할 수 있는 최대 글자 수를 정의합니다. 특성의 값은 반드시 0 이상의 정수여야 합니다.

길이는 글자의 개수에 해당하는 (더 많은 내용) UTF-16 코드 단위를 기준으로 계산됩니다. maxlength가 특정되지 않거나 올바르지 않은 값으로 설정되면 해당 입력 칸은 최대 길이의 제한이 없게 됩니다.

유효한 minlength (en-US) 값이 존재한다면 maxlength 값은 그보다 크거나 같아야만 합니다. 입력 칸의 텍스트 길이가 UTF-16 코드 단위 maxlength보다 크다면 input은 제약 조건 유효성 검사에 실패하게 됩니다. 제약 조건 유효성 검사는 사용자가 값을 변경했을 때에만 적용됩니다.

제약 조건 유효성 검사

일반적으로 브라우저는 maxlength의 범위보다 더 긴 텍스트를 입력하는 것을 방지하지만, 텍스트의 길이가 maxlength보다 커진 경우에는 ValidityState 객체의 읽기 전용 속성 tooLong (en-US)이 true가 됩니다.

시도해보기

예제

html
<input type="password" maxlength="4" />

명세

Specification
HTML Standard
# attr-input-maxlength
HTML Standard
# attr-textarea-maxlength

브라우저 호환성

html.elements.input.maxlength

BCD tables only load in the browser

html.elements.textarea.maxlength

BCD tables only load in the browser

같이 보기