CKTIS / HTML
multiple — več vrednosti v kontrolniku obrazca
Logični atribut `multiple` omogoča izbiro več možnosti v `select`, vnos več naslovov v polje `email` ali izbiro več datotek v polju `file`. O delovanju odloča prisotnost atributa, ne besedilo njegove vrednosti.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
select: multiple; input[type=email]: multiple; input[type=file]: multiple. Boolean forms: multiple | multiple="" | multiple="multiple".multiple je logični atribut: njegova prisotnost omogoči delovanje, njegova odsotnost pa ga onemogoči. Veljavni zapisi so multiple, multiple="" in multiple="multiple". Zapis multiple="false" je neveljaven in kljub temu omogoči delovanje, ker je atribut še vedno prisoten. Če ga želite onemogočiti, odstranite atribut.
Pri select omogoča izbiro nič ali več možnosti; brez njega je kontrolnik namenjen izbiri ene možnosti. Ne izbere samodejno vseh možnosti. Atribut size določa število vidnih možnosti, ne omejitve izbire.
Pri polju email omogoča seznam naslovov, ločenih z vejicami, ne s podpičji. Pri polju file omogoča izbiro več datotek; brez njega lahko seznam izbranih datotek vsebuje največ eno datoteko. Pri drugih vrstah input ne gre za splošen mehanizem za vnos več vrednosti.
Primer vsebuje dve možnosti z atributom selected. Skript prebere lastnost multiple in vrednosti iz selectedOptions, nato pa prikaže začetni rezultat. Ročna izbira možnosti ni potrebna.
Primeri
<!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>Rezultat
true html,css
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.