KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

`value` en `disabled` bij `input` en `textarea`

Lees en wijzig de waarde van een formulierveld, ook als de gebruiker het niet kan bedienen. Maak onderscheid tussen het eigen attribuut `disabled` en de werkelijke toestand en controleer welke waarden in de formuliergegevens terechtkomen.

Versie: 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 en HTMLTextAreaElement zijn DOM-interfaces uit de HTML-standaard, niet uit ECMAScript 2024. Bij tekstvelden en textarea lees en schrijf je met value de huidige tekenreeks. Bij textarea normaliseert value regeleinden naar LF (\n). De standaardwaarde (defaultValue) komt uit het attribuut value van input of de tekstinhoud van textarea. Na een wijziging door de gebruiker of een toewijzing aan value overschrijft een verandering van de standaardwaarde de huidige waarde niet meer. Bij het resetten van het formulier wordt de huidige waarde ingesteld op basis van de standaardwaarde. Voor input past de browser ook het opschoningsalgoritme voor de waarde toe, als het type er een definieert. Zo verwijdert een reset bij type="text" regeleinden uit value, ook als die in defaultValue staan.

Bij input bepaalt type hoe value werkt. In de waardemodus, zoals bij text en number, kan de browser de toegewezen tekenreeks volgens de regels van het type aanpassen of leegmaken. Ook bij number geeft value een tekenreeks terug. Bij hidden weerspiegelt value het attribuut value en geeft het '' terug als het ontbreekt. Bij checkbox en radio weerspiegelt het dat attribuut ook, maar is de terugvalwaarde 'on'; gebruik checked voor de selectiestatus. Bij file geeft value het echte bestandspad niet prijs: gebruik files. Toewijzing van '' wist de selectie; een niet-lege tekenreeks geeft InvalidStateError.

De booleaanse eigenschap disabled weerspiegelt alleen het eigen attribuut van het element: true voegt het toe, false verwijdert het. In HTML schakelt zelfs disabled="false" het veld uit, want de aanwezigheid van het attribuut telt. Een veld met disabled === false kan toch uitgeschakeld zijn door een bovenliggende uitgeschakelde fieldset, tenzij het binnen het eerste legend-kind van die groep staat. Test de werkelijke toestand met control.matches(':disabled').

Een uitgeschakeld veld kan geen focus krijgen en de gebruiker kan het niet bewerken. Het is uitgesloten van validatie van formulierbeperkingen en wordt weggelaten bij het verzenden en in new FormData(form). Scripts kunnen value nog lezen en schrijven; alleen toewijzen activeert geen input- of change-gebeurtenis. Gebruik waar ondersteund readOnly als het veld wel focus moet kunnen krijgen maar niet bewerkbaar mag zijn. Dat sluit het veld op zichzelf niet uit van verzending. Geen van beide toestanden vervangt validatie of autorisatie op de server.

Voorbeelden

<!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>

Resultaat

["Draft",false,true]
[["note","Line 1\nLine 2"]]
[["title","Draft"]]

Sla het voorbeeld op als HTML-bestand, open het in een browser en bekijk de browserconsole. De eerste regel laat zien dat je `Draft` kunt toewijzen terwijl het veld daadwerkelijk uitgeschakeld is en zijn eigen `disabled` op `false` staat. De volgende twee regels tonen de formuliergegevens vóór en na de toestandswijziging; in JSON staat `\n` voor een LF-regeleinde.

Gerelateerde lessen

  • JavaScript · Les 4 · Gevorderd · Versie: 4

Bronnen