CKTIS / JavaScript
`value` in `disabled` pri elementih `input` in `textarea`
Preberi ali spremeni vrednost polja ne glede na to, ali ga uporabnik lahko uporablja. Loči atribut `disabled` na samem elementu od dejanskega stanja in preveri, katere vrednosti so vključene v podatke obrazca.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
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 in HTMLTextAreaElement sta vmesnika DOM, ki ju določa standard HTML, ne ECMAScript 2024. Pri besedilnem polju input in pri textarea lastnost value bere in nastavlja trenutni niz. V textarea lastnost value normalizira konce vrstic v LF (\n). Privzeta vrednost (defaultValue) izvira iz atributa value elementa input ali iz besedilne vsebine elementa textarea. Ko uporabnik uredi vrednost ali jo nastaviš prek value, sprememba privzete vrednosti ne prepiše več trenutne. Ob ponastavitvi obrazca se trenutna vrednost nastavi na podlagi privzete. Pri input brskalnik uporabi tudi algoritem za čiščenje vrednosti, če ga tip določa. Pri type="text" denimo ponastavitev odstrani prelome vrstic iz value, tudi če so prisotni v defaultValue.
Pri input lastnost type določa delovanje value. V načinu vrednosti, na primer pri text in number, lahko brskalnik dodeljeni niz spremeni ali izprazni po pravilih tipa; tudi number vrne niz. Pri hidden lastnost value odraža atribut value in vrne '', če ga ni. Pri checkbox in radio prav tako odraža atribut, a brez njega vrne 'on'; za stanje izbire uporabi checked. Pri file lastnost value ne razkrije dejanske poti: uporabi files. Dodelitev '' počisti izbiro, neprazen niz pa sproži InvalidStateError.
Logična lastnost disabled odraža samo atribut na tem elementu: true ga doda, false ga odstrani. V HTML celo disabled="false" onemogoči polje, ker šteje prisotnost atributa. Polje z disabled === false je lahko vseeno onemogočeno zaradi onemogočenega nadrejenega fieldset, razen če je znotraj njegovega prvega otroka legend. Dejansko stanje preveri z control.matches(':disabled').
Onemogočeno polje ne more prejeti fokusa in ga uporabnik ne more urediti. Izključeno je iz preverjanja omejitev in izpuščeno pri oddaji obrazca ter v new FormData(form). Skripte lahko value še vedno berejo in zapisujejo; sama dodelitev ne sproži dogodkov input ali change. Kjer je podprto, uporabi readOnly, če naj polje še vedno prejme fokus, urejanje pa naj ne bo mogoče. To samo po sebi polja ne izključi iz oddaje. Nobeno od teh stanj ne nadomesti preverjanja podatkov ali pooblastil na strežniku.
Primeri
<!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>Rezultat
["Draft",false,true] [["note","Line 1\nLine 2"]] [["title","Draft"]]
Shrani primer kot datoteko HTML, odpri jo v brskalniku in poglej v konzolo brskalnika. Prva vrstica pokaže, da lahko dodeliš `Draft`, četudi je polje dejansko onemogočeno in je njegov `disabled` enak `false`. Naslednji vrstici prikažeta podatke pred spremembo stanja in po njej; `\n` v JSON predstavlja konec vrstice LF.
Povezane lekcije
- JavaScript · Lekcija 4 · Napredna · Različica: 4
Viri
- 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