Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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 disabled

HTMLInputElement 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