CKTIS / HTML
multiple — varios valores en un control de formulario
El atributo booleano `multiple` permite elegir varias opciones en `select`, introducir varias direcciones en un campo `email` o seleccionar varios archivos en un campo `file`. El comportamiento depende de que el atributo esté presente, no del texto de su valor.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
select: multiple; input[type=email]: multiple; input[type=file]: multiple. Boolean forms: multiple | multiple="" | multiple="multiple".multiple es un atributo booleano: su presencia activa el comportamiento y su ausencia lo desactiva. Las formas válidas son multiple, multiple="" y multiple="multiple". Escribir multiple="false" no es válido y aun así activa el comportamiento, porque el atributo sigue presente. Para desactivarlo, elimina el atributo.
En select, permite seleccionar cero o más opciones; sin él, el control sirve para seleccionar una sola opción. No selecciona automáticamente todas las opciones. El atributo size determina cuántas opciones son visibles, no el límite de selección.
En un campo email, permite una lista de direcciones separadas por comas, no por punto y coma. En un campo file, permite seleccionar varios archivos; sin él, la lista de archivos seleccionados puede contener como máximo uno. No es un mecanismo general para introducir varios valores en los demás tipos de input.
El ejemplo tiene dos opciones con el atributo selected. El script lee la propiedad multiple y los valores de selectedOptions, y después muestra el resultado inicial. No es necesario seleccionar opciones manualmente.
Ejemplos
<!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>Resultado
true html,css
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.