HTMLInputElement: свойство checked

Базовая поддержка Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.

Свойство checked интерфейса HTMLInputElement указывает на текущее состояние выбора элемента; то есть, находится ли элемент управления в выбранном состоянии или нет.

Булево свойство checked актуально для типов ввода radio (<input type="radio">) и checkbox (<input type="checkbox">).

Наличие атрибута HTML checked указывает, что флажок установлен по умолчанию. Он не указывает, установлен ли этот флажок в текущий момент: если состояние флажка изменено, этот атрибут не отражает изменения; обновляется только свойство IDL HTMLInputElement checked. Атрибут checked отражается свойством defaultChecked.

Когда свойство checked радиокнопки true, все остальные радиокнопки с тем же name устанавливаются в false состояние. Если какая-либо радиокнопка в группе радиокнопок с одинаковым именем имеет required атрибут, и при этом хотя бы одна кнопка в группе установлена в checked состояние, то свойство ValidityState, только для чтения, valueMissing для каждой радиокнопки в группе будет false.

Значение флажка включается в отправляемые данные при отправке формы только если checked равно true. Значение свойства HTMLInputElement.indeterminate не влияет на значение checked флажка.

Значение

Булево значение.

Примеры

const inputElement = document.getElementById("contactMail");
console.log(inputElement.checked);
inputElement.checked = true;

Спецификации

Спецификация
HTML # dom-input-checked

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	WebView Android
`checked`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/checked