CKTIS / JavaScript
Деактивирани контроли на формуляр
Потребителите не могат да използват деактивираните контроли на формуляр или да им зададат фокус, а стойностите им не се изпращат. В JavaScript свойството `disabled` превключва собственото състояние на деактивиране на контролата, но и `fieldset`, който я съдържа, може да я деактивира.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
control.disabled = true;
control.disabled = false;
control.matches(':disabled');Деактивираните контроли на формуляр са контроли на формуляр, които са деактивирани. Потребителите не могат да ги редактират или активират с щракване; те не могат да получат фокус и не участват във валидирането на ограниченията. Стойностите им се пропускат при изпращане на формуляра. Това е механизъм на HTML и DOM на браузъра, а не функция на конкретно издание на ECMAScript. MDN посочва, че HTMLInputElement.disabled е широко достъпно в браузърите от юли 2015 г.; наличието на Node 24 не доказва поддръжка на DOM.
Свойството input.disabled е булева стойност, която отразява собствения атрибут disabled на елемента. Задаването на true добавя атрибута, а задаването на false го премахва. Атрибутът е булев: дори disabled="false" означава деактивирано, защото значение има наличието на атрибута, а не текстовата му стойност.
Деактивиран fieldset деактивира и контролите, които са негови потомци, с изключение на тези в първия елемент legend, който е негово пряко дете. Самото наличие на контрола в елемент legend на вложен fieldset не пречи на външния fieldset да я деактивира. Затова input.disabled може да е false, докато предшественик все още деактивира контролата; използвайте input.matches(':disabled'), за да проверите ефективното ѝ състояние. Самото задаване на input.disabled = false не отменя деактивирането, наложено от fieldset.
Не бъркайте disabled с readonly: поддържаните полета само за четене все пак могат да получат фокус и да включат стойностите си при изпращане на формуляра. readonly се прилага за текстовите типове input и за textarea, но не например за select или button. Примерът показва превключването на disabled и произтичащото пропускане на полето от FormData.
Примери
const form = document.createElement('form');
const input = document.createElement('input');
input.name = 'topic';
input.value = 'JavaScript';
form.append(input);
input.disabled = true;
console.log(input.disabled);
console.log(new FormData(form).has('topic'));
input.disabled = false;
console.log(new FormData(form).get('topic'));Резултат
true false JavaScript
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.