Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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 disabled

HTMLInputElement 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