CKTIS / JavaScript
Деактивиране на контроли в HTML формуляр с `disabled`
`disabled` деактивира контрола в HTML формуляр и я изключва от проверката за валидност и от данните на формуляра. Свойството `.disabled` и селекторът `:disabled` проверяват различни неща.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
<input name="city" disabled>
<script>
const input = document.querySelector('input[name="city"]');
input.disabled = true;
input.disabled = false;
input.matches(":disabled");
</script>disabled е булев атрибут в HTML: важно е дали присъства, затова дори disabled="false" деактивира елемента. Това важи например за input, button, select, textarea и потребителски елементи, свързани с формуляр. За option и optgroup има отделни правила: опциите в деактивиран optgroup не могат да се избират, но самият select не се деактивира от това.
Деактивираният fieldset деактивира вложените контроли с изключение на тези в първия елемент legend, който е негово пряко дете, ако има такъв. При input свойството .disabled отразява само собствения атрибут на полето: true го добавя, а false го премахва. Използвай input.matches(":disabled"), за да провериш действителното състояние, включително ефекта на fieldset.
Потребителят не може да фокусира деактивирана контрола или да я използва по обичайния начин, но скрипт може да промени например input.value. Браузърът пропуска контролата при проверка на ограниченията за валидност и при съставяне на данните на формуляра, включително с new FormData(form). При текстови полета, които поддържат readonly, този атрибут не позволява редактиране от потребителя и изключва полето от проверката на ограниченията, но сам по себе си не пречи на фокусирането или включването му в данните на формуляра.
Това са възможности на уеб платформата, а не на ECMAScript. Деактивирането не е мярка за сигурност: проверявай данните и правата за достъп на сървъра.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Disabled form control</title>
</head>
<body>
<script>
const form = document.createElement("form");
const group = document.createElement("fieldset");
const input = document.createElement("input");
input.name = "city";
input.value = "Oslo";
group.append(input);
form.append(group);
const report = () => console.log(JSON.stringify([
input.disabled,
input.matches(":disabled"),
input.willValidate,
new FormData(form).has("city")
]));
group.disabled = true;
report();
group.disabled = false;
report();
</script>
</body>
</html>Резултат
[false,true,false,false] [false,false,true,true]
Всеки ред показва последователно `.disabled`, съвпадението с `:disabled`, `.willValidate` и наличието на записа `city`. При повторното активиране на `fieldset` последните три резултата се променят; полето никога няма собствен атрибут `disabled`.
Свързани уроци
- JavaScript · Урок 20 · Средно · Версия: 3
- JavaScript · Урок 21 · Средно · Версия: 3