HTMLInputElement: minLength property

The minLength property of the HTMLInputElement interface indicates the minimum number of characters (in UTF-16 code units) required for the value of the <input> element to be valid. It reflects the element's minlength attribute. -1 means there is no minimum length requirement.

Note: If the input has a value, and that value has fewer characters than the minlength attribute requires, the element is considered invalid and the ValidityState object's tooShort property will be true.

Value

A number representing the element's minlength if present or -1.

Example

Given the following HTML:

html
<p>
  <label for="password">Your password</label>
  <input id="password" type="password" minlength="8" maxlength="20" />
</p>

You can use the minLength property to retrieve or set the <input>'s minlength attribute value:

js
const inputElement = document.querySelector("#password");
console.log(`Element's minLength: ${inputElement.minLength}`); // "Element's minlength: 8"
inputElement.minLength = 12; // updates the element's minlength attribute value

Specifications

Specification
HTML Standard
# dom-input-minlength

Browser compatibility

BCD tables only load in the browser

See also