CKTIS / HTML
checked: standaardselectie en huidige selectie
Begrijp standaardwaarden van selectievakjes en keuzerondjes, gebruikerswijzigingen en formulierreset.
Versie: HTML Living Standard
Syntax
<input type="checkbox" name="topic" value="html" checked>Het booleaanse attribuut checked geeft een selectievakje of keuzerondje zijn standaard aangevinkte toestand. Aanwezigheid telt, dus ook checked="false" geeft een aangevinkte standaard op. Keuzerondjes in dezelfde groep staan slechts één huidige selectie toe; een selectievakje is onafhankelijk te kiezen. Dit attribuut is niet het mechanisme voor standaardwaarden van gewone tekstvelden.
Maak na interactie onderscheid tussen de huidige DOM-eigenschap checked en defaultChecked, die het standaardattribuut weerspiegelt. Het attribuut wijzigen vervangt niet betrouwbaar het wijzigen van de huidige toestand zodra het veld als gewijzigd geldt. Het formulier resetten herstelt de standaardwaarden. Een uitgevinkt selectievakje wordt uit gewone formuliergegevens weggelaten en niet als de boolean false verzonden.
Het voorbeeld begint aangevinkt, activeert het veld om het uit te vinken, onderzoekt de verzonden velden en reset het formulier. De uitvoer toont zowel het weglaten tijdens de uitgevinkte toestand als het herstel van de aangevinkte standaard. Een gemengde visuele checkboxstatus is een afzonderlijke, door scripts geregelde eigenschap en geen derde attribuutwaarde.
Voorbeelden
<!doctype html><meta charset="utf-8">
<form id="form"><label><input id="topic" type="checkbox" name="topic" value="html" checked> HTML</label></form>
<output id="result"></output><script>
const field = document.querySelector('#topic'), form = document.querySelector('#form');
const initial = field.checked;
field.click();
const afterClick = field.checked, submitted = new FormData(form).has('topic');
form.reset();
document.querySelector('#result').textContent = 'initial=' + initial + '; afterClick=' + afterClick + '; submitted=' + submitted + '; afterReset=' + field.checked + '; default=' + field.defaultChecked;
</script>Resultaat
initial=true; afterClick=false; submitted=false; afterReset=true; default=true
De controle van formuliergegevens gaat over de aanwezigheid van het benoemde veld, niet of de tekstwaarde gelijk is aan true.