HTML attribute: maxlength

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

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

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

제약 조건 유효성 검사

일반적으로 브라우저는 maxlength의 범위보다 더 긴 텍스트를 입력하는 것을 방지하지만, 텍스트의 길이가 maxlength보다 커진 경우에는 ValidityState 객체의 읽기 전용 속성 tooLong이 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

같이 보기