CKTIS / JavaScript
`value` a `disabled` v prvkoch `input` a `textarea`
Čítajte a meňte hodnotu poľa bez ohľadu na to, či ho používateľ môže ovládať. Rozlíšte vlastný atribút `disabled` od skutočného stavu poľa a zistite, ktoré hodnoty sa dostanú do údajov formulára.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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 sú rozhrania DOM definované štandardom HTML, nie špecifikáciou ECMAScript 2024. V textovom input a v textarea vlastnosť value číta a nastavuje aktuálny reťazec. V textarea normalizuje konce riadkov na LF (\n). Predvolená hodnota (defaultValue) pochádza z atribútu value prvku input alebo z textového obsahu textarea. Po úprave používateľom alebo priradení do value zmena predvolenej hodnoty už neprepíše aktuálnu hodnotu. Pri obnovení formulára sa aktuálna hodnota nastaví podľa predvolenej hodnoty. V prípade input prehliadač použije aj algoritmus na očistenie hodnoty, ak ho daný typ definuje. Napríklad pri type="text" obnovenie odstráni z value znaky konca riadka, aj keď sú v defaultValue.
V input vlastnosť type určuje správanie value. V režime hodnoty, napríklad pri text a number, môže prehliadač podľa pravidiel typu upraviť alebo vyprázdniť priradený reťazec; aj number stále vracia reťazec. Pri hidden vlastnosť value odráža atribút value a vracia '', ak chýba. Pri checkbox a radio tiež odráža atribút, no ak chýba, vracia 'on'; stav začiarknutia zisťujte cez checked. Pri file vlastnosť value neodhalí skutočnú cestu: použite files. Priradenie '' vymaže výber, neprázdny reťazec vyvolá InvalidStateError.
Logická vlastnosť disabled odráža iba vlastný atribút prvku: true ho pridá, false odstráni. V HTML zneprístupní pole aj disabled="false", pretože rozhoduje prítomnosť atribútu. Pole s disabled === false môže byť napriek tomu neaktívne pre nadradený neaktívny fieldset, pokiaľ nie je vo vnútri jeho prvého priameho potomka typu legend. Skutočný stav overte pomocou control.matches(':disabled').
Neaktívne pole nemôže získať fokus ani ho používateľ nemôže upraviť. Vynecháva sa pri overovaní obmedzení, pri odoslaní formulára aj v new FormData(form). Skripty môžu value naďalej čítať a zapisovať; samotné priradenie nevyvoláva input ani change. Kde je to podporované, použite readOnly, ak pole má získať fokus, ale nemá sa dať upraviť; samo osebe ho nevylúči z odoslania. Ani jeden z týchto stavov nenahrádza validáciu ani autorizáciu na serveri.
Prí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ýsledok
["Draft",false,true] [["note","Line 1\nLine 2"]] [["title","Draft"]]
Uložte príklad ako súbor HTML, otvorte ho v prehliadači a pozrite si konzolu prehliadača. Prvý riadok ukazuje, že `Draft` možno priradiť aj vtedy, keď je pole skutočne neaktívne a jeho vlastné `disabled` je `false`. Ďalšie dva riadky ukazujú údaje pred zmenou stavu a po nej; v JSON označuje `\n` koniec riadka LF.
Súvisiace lekcie
- JavaScript · Lekcia 4 · Pokročilá · Verzia: 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