База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

multiple — множество стойности в контрола на формуляр

Булевият атрибут `multiple` позволява избор на няколко опции в `select`, въвеждане на няколко адреса в поле `email` или избор на няколко файла в поле `file`. Поведението зависи от наличието на атрибута, а не от текста на стойността му.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

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

multiple е булев атрибут: наличието му включва поведението, а липсата му го изключва. Валидните форми са multiple, multiple="" и multiple="multiple". Записът multiple="false" е невалиден и въпреки това включва поведението, защото атрибутът продължава да присъства. За да го изключите, премахнете атрибута.

При select атрибутът позволява да бъдат избрани нула или повече опции; без него контролът служи за избор на една опция. Той не избира автоматично всички опции. Атрибутът size определя броя на видимите опции, а не ограничението за избор.

При поле email той позволява списък с адреси, разделени със запетаи, а не с точка и запетая. При поле file позволява избор на няколко файла; без него списъкът с избрани файлове може да съдържа най-много един файл. За останалите типове input това не е общ механизъм за въвеждане на множество стойности.

Примерът съдържа две опции с атрибута selected. Скриптът прочита свойството multiple и стойностите от selectedOptions, след което показва първоначалния резултат. Не е необходимо опциите да се избират ръчно.

Примери

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

Резултат

true
html,css

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници