CKTIS / HTML
multiple — více hodnot v ovládacím prvku formuláře
Logický atribut `multiple` umožňuje vybrat více možností v `select`, zadat více adres do pole `email` nebo vybrat více souborů v poli `file`. O chování rozhoduje přítomnost atributu, nikoli text jeho hodnoty.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
select: multiple; input[type=email]: multiple; input[type=file]: multiple. Boolean forms: multiple | multiple="" | multiple="multiple".multiple je logický atribut: jeho přítomnost zapíná dané chování a jeho nepřítomnost je vypíná. Platné zápisy jsou multiple, multiple="" a multiple="multiple". Zápis multiple="false" je neplatný a chování přesto zapíná, protože atribut zůstává přítomen. Chcete-li chování vypnout, atribut odeberte.
U select umožňuje vybrat žádnou nebo více možností; bez něj slouží ovládací prvek k výběru jediné možnosti. Automaticky nevybere všechny možnosti. Atribut size určuje počet viditelných možností, nikoli limit výběru.
U pole email umožňuje seznam adres oddělených čárkami, nikoli středníky. U pole file umožňuje vybrat více souborů; bez něj může seznam vybraných souborů obsahovat nejvýše jeden soubor. U ostatních typů input nejde o obecný způsob zadávání více hodnot.
Příklad obsahuje dvě možnosti s atributem selected. Skript načte vlastnost multiple a hodnoty z selectedOptions a potom zobrazí počáteční výsledek. Ruční výběr možností není potřeba.
Příklady
<!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>Výsledek
true html,css
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.