HTMLInputElement: maxLength property
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
The maxLength
property of the HTMLInputElement
interface indicates the maximum number of characters (in UTF-16 code units) allowed to be entered for the value of the <input>
element, and the maximum number of characters allowed for the value to be valid. It reflects the element's maxlength
attribute. -1
means there is no limit on the length of the value.
Note:
Browser generally prevent users from entering more characters than the maxlength
attribute allows. Should the length be longer, the element is considered invalid and the ValidityState
object's tooLong
property will be true
.
Value
A number representing the element's maxlength
if present, or -1
.
Example
Given the following HTML:
<p>
<label for="password">Your password</label>
<input id="password" type="password" minlength="8" maxlength="20" />
</p>
You can use the maxLength
property to retrieve or set the <input>
's maxlength
attribute value:
const inputElement = document.querySelector("#password");
console.log(`Element's maxLength: ${inputElement.maxLength}`); // "Element's maxlength: 20"
inputElement.maxLength = 18; // updates the element's maxlength attribute value
Specifications
Specification |
---|
HTML Standard # dom-input-maxlength |
Browser compatibility
BCD tables only load in the browser