Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

Atributo HTML name — significado específico de cada elemento

El atributo `name` proporciona un nombre específico del elemento: una clave de datos de formulario, un nombre de destino de navegación, un nombre de mapa de imagen, un grupo `details`, un nombre de slot o un nombre de metadatos. No es global ni sustituye a `id`.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

name="value"

name no es un atributo global: su significado y sus restricciones dependen del elemento. No sustituye a id ni a una etiqueta accesible dirigida al usuario. En particular, label[for] hace referencia al id de un control, no a su name.

En los controles de formulario, name proporciona el nombre utilizado al enviar los datos y en la colección form.elements. El valor especificado no puede estar vacío ni ser isindex. Los nombres repetidos pueden producir varias entradas; un nombre compartido también agrupa los botones de opción que pertenecen al mismo formulario y árbol. Un campo de texto normal sin nombre no aporta ninguna entrada. El nombre por sí solo no garantiza el envío: se omiten, por ejemplo, los controles deshabilitados y las casillas sin marcar. Evita nombres de propiedades integradas de formulario, como submit: pueden ocultar esas propiedades en el DOM.

En form, el nombre permite buscar el formulario mediante document.forms; debe ser distinto de vacío y único dentro de esa colección. En iframe y, cuando corresponda, object, da nombre al destino de navegación interno cuando se crea, por ejemplo, para usarlo con target. Debe ser un nombre de destino navegable válido. En map, el atributo es obligatorio: el nombre al que hace referencia usemap debe ser distinto de vacío, no contener espacios en blanco ASCII y ser único en su árbol; cualquier id especificado debe coincidir con él.

En details, un nombre compartido no vacío crea un grupo dentro del mismo árbol: al abrir un miembro se cierran los demás. No anides miembros del mismo grupo ni declares varios como abiertos. Considera si los usuarios necesitan ver varias secciones a la vez. En slot, el nombre identifica un slot en un árbol de sombra y coincide con el atributo slot de un hijo del host; puede ser una cadena vacía.

En meta, el nombre identifica el tipo de metadato, como description, mientras que content proporciona su valor. Los nombres de metadatos se comparan sin distinguir mayúsculas y minúsculas ASCII. No combines name con http-equiv, charset o itemprop en el mismo meta.

Ejemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>name example</title>
<form id="profile" name="profileForm">
  <label>City <input id="city" name="city" value="Warsaw"></label>
  <input name="tag" value="html" type="hidden">
  <input name="tag" value="forms" type="hidden">
  <label>Ignored <input value="not submitted"></label>
</form>
<pre id="result"></pre>
<script>
  const form = document.getElementById("profile");
  const pairs = [...new FormData(form).entries()];
  document.getElementById("result").textContent = JSON.stringify(pairs);
</script>
</html>

Resultado

[["city","Warsaw"],["tag","html"],["tag","forms"]]

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.

Fuentes