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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.