CKTIS / HTML
multiple — meerdere waarden in een formulierbesturingselement
Met het booleaanse attribuut `multiple` kun je meerdere opties kiezen in `select`, meerdere adressen invoeren in een `email`-veld of meerdere bestanden selecteren in een `file`-veld. Het gedrag hangt af van de aanwezigheid van het attribuut, niet van de tekst van de waarde.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
select: multiple; input[type=email]: multiple; input[type=file]: multiple. Boolean forms: multiple | multiple="" | multiple="multiple".multiple is een booleaans attribuut: als het aanwezig is, wordt het gedrag ingeschakeld; als het ontbreekt, wordt het uitgeschakeld. Geldige vormen zijn multiple, multiple="" en multiple="multiple". multiple="false" schrijven is ongeldig en schakelt het gedrag toch in, omdat het attribuut aanwezig blijft. Verwijder het attribuut om het gedrag uit te schakelen.
Bij select kunnen zo nul of meer opties worden geselecteerd; zonder het attribuut is het besturingselement bedoeld om één optie te kiezen. Het selecteert niet automatisch alle opties. Het attribuut size bepaalt hoeveel opties zichtbaar zijn, niet hoeveel opties geselecteerd mogen worden.
Bij een email-veld is een lijst met adressen toegestaan die door komma’s en niet door puntkomma’s worden gescheiden. Bij een file-veld kunnen meerdere bestanden worden geselecteerd; zonder het attribuut kan de lijst met geselecteerde bestanden hoogstens één bestand bevatten. Voor andere input-typen is dit geen algemeen mechanisme om meerdere waarden in te voeren.
Het voorbeeld bevat twee opties met het attribuut selected. Het script leest de eigenschap multiple en de waarden uit selectedOptions en toont daarna het oorspronkelijke resultaat. Handmatig opties selecteren is niet nodig.
Voorbeelden
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>multiple example</title>
<label for="topics">Topics</label>
<select id="topics" multiple>
<option value="html" selected>HTML</option>
<option value="css" selected>CSS</option>
</select>
<pre id="result"></pre>
<script>
const topics = document.getElementById('topics');
const values = Array.from(topics.selectedOptions, option => option.value);
document.getElementById('result').textContent =
`${topics.multiple}\n${values.join(',')}`;
</script>
</html>Resultaat
true html,css
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.