HTMLInputElement: indeterminate 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 indeterminate property of the HTMLInputElement interface returns a boolean value that indicates whether the checkbox is in the indeterminate state. For example, a "select all/deselect all" checkbox may be in the indeterminate state when some but not all of its sub-controls are checked. The indeterminate state can only be set via JavaScript and is only relevant to checkbox controls.

It is unrelated to the HTMLInputElement.checked property, and an indeterminate checkbox can be either checked or unchecked. Being indeterminate only affects the checkbox's appearance (see example below), not its presence when submitted (which is controlled by the checkedness).

Value

A boolean.

Examples

html
<input type="checkbox" id="indeterminate-checkbox" />
<label for="indeterminate-checkbox">Indeterminate checkbox</label>
js
const checkbox = document.getElementById("indeterminate-checkbox");
checkbox.indeterminate = true;

Specifications

Specification
HTML
# dom-input-indeterminate

Browser compatibility

BCD tables only load in the browser

See also