CKTIS / HTML
select — selectiebesturing
Met het element `select` kunnen gebruikers een keuze maken uit formulieropties. Lees over enkelvoudige en meervoudige selectie, labels en de rol van `name` bij het verzenden van gegevens.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<select name="field" id="field"><option value="value">Label</option></select>select biedt een keuze uit option-elementen. Zonder multiple kan één optie worden geselecteerd; met multiple kunnen nul of meer opties worden geselecteerd. size bepaalt hoeveel items zichtbaar zijn.
Koppel een label aan de besturing door de waarden van for en id overeen te laten komen. name is de sleutel in de formuliergegevens, terwijl id de besturing identificeert en niet de verzendsleutel is. Elke geselecteerde, ingeschakelde optie draagt de eigen waarde bij; bij multiple kan de sleutel meerdere keren voorkomen. Een besturing met disabled wordt overgeslagen.
Bij een verplichte enkelvoudige selectie met een weergavegrootte van 1 moet de eerste optie als tijdelijke aanduiding dienen: de waarde moet leeg zijn en de optie moet een direct kind van select zijn, niet van een optgroup of een ander element. Alleen die optie selecteren voldoet niet aan required.
In het voorbeeld is de optie dark aanvankelijk geselecteerd. Het script leest de formuliergegevens uit zonder ze naar een server te verzenden. Het resultaat geeft de begintoestand weer en wordt niet bijgewerkt wanneer de selectie verandert.
Voorbeelden
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Select example</title>
<form id="settings">
<label for="theme">Theme</label>
<select id="theme" name="theme" required>
<option value="">Choose a theme</option>
<option value="light">Light</option>
<option value="dark" selected>Dark</option>
</select>
</form>
<pre id="result"></pre>
<script>
const form = document.getElementById('settings');
const data = new FormData(form);
document.getElementById('result').textContent = data.get('theme');
</script>
</html>Resultaat
dark
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.