База знанияИзпитен център
BGБългарски
Избери език13

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

Източници