CKTIS / JavaScript
`value` и `disabled` при елементите `input` и `textarea`
Чети и променяй стойността на поле независимо дали потребителят може да го използва. Разграничавай собствения атрибут `disabled` от действителното състояние и проверявай кои стойности влизат в данните на формуляра.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
control.value // read a string
control.value = text // write a string; input.type determines the rules
control.disabled // read the element's own disabled attribute as a boolean
control.disabled = true
control.disabled = false
control.matches(':disabled') // test whether the control is actually disabledHTMLInputElement и HTMLTextAreaElement са DOM интерфейси, определени от стандарта HTML, а не от ECMAScript 2024. При текстов input и при textarea свойството value чете и задава текущия низ. При textarea то нормализира знаците за нов ред до LF (\n). Стойността по подразбиране (defaultValue) идва от атрибута value на input или от текстовото съдържание на textarea. След редакция от потребителя или присвояване на value промяната на стойността по подразбиране вече не презаписва текущата. При нулиране на формуляра текущата стойност се задава въз основа на стойността по подразбиране. При input браузърът прилага и алгоритъма за изчистване на стойността, ако типът определя такъв. Например при type="text" нулирането премахва знаците за нов ред от value, дори да присъстват в defaultValue.
При input свойството type определя поведението на value. В режим на стойност, например при text и number, браузърът може да преобразува или изчисти присвоения низ според правилата на типа; при number резултатът пак е низ. При hidden свойството value отразява атрибута value и връща '', ако той липсва. При checkbox и radio също го отразява, но при липса връща 'on'; за състоянието на отметката използвай checked. При file свойството value не разкрива действителния път: използвай files. Присвояването на '' изчиства избора, а непразен низ предизвиква InvalidStateError.
Булевото свойство disabled отразява само собствения атрибут на елемента: true го добавя, а false го премахва. В HTML дори disabled="false" деактивира полето, защото е важно наличието на атрибута. Поле с disabled === false може все пак да е деактивирано от деактивиран предшественик fieldset, освен ако се намира в първото му дете legend. Провери действителното състояние с control.matches(':disabled').
Деактивираното поле не може да получи фокус или да бъде редактирано от потребителя. То не участва в проверката на ограниченията и се пропуска при изпращане на формуляра и в new FormData(form). Скриптовете все още могат да четат и записват value; самото присвояване не задейства input или change. Където се поддържа, използвай readOnly, ако полето трябва да може да получава фокус, но да не се редактира. Това само по себе си не изключва полето от изпращането. Нито едно от двете състояния не заменя проверката на данните или правата за достъп на сървъра.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Form control value and disabled state</title>
</head>
<body>
<script>
(() => {
const form = document.createElement('form');
const group = document.createElement('fieldset');
const input = document.createElement('input');
const textarea = document.createElement('textarea');
input.type = 'text';
input.name = 'title';
textarea.name = 'note';
group.append(input);
form.append(group, textarea);
group.disabled = true;
input.value = 'Draft';
textarea.value = 'Line 1\r\nLine 2';
console.log(JSON.stringify([input.value, input.disabled, input.matches(':disabled')]));
console.log(JSON.stringify([...new FormData(form)]));
group.disabled = false;
textarea.disabled = true;
console.log(JSON.stringify([...new FormData(form)]));
})();
</script>
</body>
</html>Резултат
["Draft",false,true] [["note","Line 1\nLine 2"]] [["title","Draft"]]
Запази примера като HTML файл, отвори го в браузър и провери конзолата на браузъра. Първият ред показва, че `Draft` може да се присвои, въпреки че полето действително е деактивирано, а собственото му свойство `disabled` е `false`. Следващите два реда показват данните преди и след промяната на състоянието; в JSON `\n` представя нов ред LF.
Свързани уроци
- JavaScript · Урок 4 · Напреднало · Версия: 4
Източници
- HTML Living Standard — The input element
- HTML Living Standard — The textarea element
- HTML Living Standard — Enabling and disabling form controls: the disabled attribute
- HTML Living Standard — Constructing the entry list
- HTML Living Standard — Common event behaviors
- MDN — FormData: FormData() constructor
- MDN — disabled HTML attribute