Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

multiple — wiele wartości w kontrolce formularza

Atrybut logiczny `multiple` umożliwia wybór wielu opcji w `select`, podanie wielu adresów w `input` typu `email` lub wybranie wielu plików w `input` typu `file`. O jego działaniu decyduje obecność, a nie tekst wartości.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

select: multiple; input[type=email]: multiple; input[type=file]: multiple. Boolean forms: multiple | multiple="" | multiple="multiple".

multiple jest atrybutem logicznym: jego obecność włącza zachowanie, a brak je wyłącza. Poprawne zapisy to multiple, multiple="" i multiple="multiple". Zapis multiple="false" jest niepoprawny i nadal włącza zachowanie, ponieważ atrybut pozostaje obecny. Aby je wyłączyć, usuń atrybut.

W select umożliwia zaznaczenie zera lub większej liczby opcji; bez niego kontrolka służy do wyboru pojedynczej opcji. Nie zaznacza automatycznie wszystkich opcji. Atrybut size określa liczbę widocznych opcji, a nie limit zaznaczeń.

W input typu email dopuszcza listę adresów oddzielonych przecinkami, nie średnikami. W input typu file pozwala wybrać wiele plików; bez niego lista wybranych plików może zawierać najwyżej jeden plik. Nie jest ogólnym mechanizmem wielokrotnego wprowadzania danych dla pozostałych typów input.

Przykład ma dwie opcje z atrybutem selected. Skrypt odczytuje właściwość multiple i wartości z selectedOptions, a następnie wyświetla wynik początkowy. Nie wymaga ręcznego wybierania opcji.

Przykłady

<!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>

Wynik

true
html,css

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła