CKTIS / JavaScript
`value` a `disabled` u prvků `input` a `textarea`
Čtěte a měňte hodnotu formulářového pole nezávisle na tom, zda ho uživatel může ovládat. Rozlišujte vlastní atribut `disabled` od skutečného stavu pole a zjistěte, které hodnoty se dostanou do dat formuláře.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
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 a HTMLTextAreaElement jsou rozhraní DOM definovaná standardem HTML, nikoli specifikací ECMAScript 2024. U textového input a u textarea vlastnost value čte a nastavuje aktuální řetězec. U textarea normalizuje konce řádků na LF (\n). Výchozí hodnota (defaultValue) pochází z atributu value prvku input nebo z textového obsahu textarea. Po úpravě uživatelem nebo přiřazení do value změna výchozí hodnoty už aktuální hodnotu nepřepíše. Při resetu formuláře se aktuální hodnota nastaví podle výchozí. U input prohlížeč navíc použije algoritmus pro očištění hodnoty, pokud ho daný typ definuje. Například u type="text" reset odstraní z value znaky konce řádku, i když jsou v defaultValue.
U input rozhoduje o chování value vlastnost type. V režimu hodnoty, například u text a number, může prohlížeč přiřazený řetězec podle pravidel daného typu upravit nebo vyprázdnit; i u number vrací řetězec. U hidden vlastnost value odráží atribut value, a pokud chybí, vrací ''. U checkbox a radio také odráží atribut, ale při jeho absenci vrací 'on'; stav zaškrtnutí zjistíte pomocí checked. U file vlastnost value neprozrazuje skutečnou cestu: použijte files. Přiřazení '' zruší výběr, neprázdný řetězec vyvolá InvalidStateError.
Logická vlastnost disabled odráží pouze vlastní atribut prvku: true ho přidá a false odstraní. V HTML pole znepřístupní i disabled="false", protože rozhoduje přítomnost atributu. Pole s disabled === false může být přesto neaktivní kvůli nadřazenému neaktivnímu prvku fieldset, pokud není uvnitř jeho prvního potomka typu legend, který je jeho přímým dítětem. Skutečný stav ověřte pomocí control.matches(':disabled').
Neaktivní pole nemůže získat fokus ani ho uživatel nemůže upravit. Neúčastní se ověřování formulářových omezení a vynechává se při odeslání formuláře i v new FormData(form). Skripty mohou value dál číst a nastavovat; samotné přiřazení nevyvolá událost input ani change. Kde je to podporováno, použijte readOnly, má-li pole přijímat fokus, ale nemá jít upravovat. Samo o sobě pole z odeslání nevyloučí. Žádný z těchto stavů nenahrazuje validaci ani autorizaci na serveru.
Příklady
<!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>Výsledek
["Draft",false,true] [["note","Line 1\nLine 2"]] [["title","Draft"]]
Uložte příklad jako soubor HTML, otevřete ho v prohlížeči a podívejte se do konzole prohlížeče. První řádek ukazuje, že lze přiřadit `Draft`, i když je pole skutečně neaktivní a jeho vlastní `disabled` je `false`. Další dva řádky ukazují data před změnou stavu a po ní; v JSON představuje `\n` konec řádku LF.
Související lekce
- JavaScript · Lekce 4 · Pokročilá · Verze: 4
Zdroje
- 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