Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje