Element.setAttribute

name

Un DOMString indicando el nombre del atributo cuyo valor se va a cambiar. El nombre del atributo se convierte automáticamente en minúsculas cuando setAttribute() se llama sobre un elemento HTML en un documento HTML.

value

Un DOMString que contenga el valor que asignar al atributo. Cualquier valor indicado que no sea una cadena de texto se convierte automáticamente en una cadena de texto.

Los atributos booleanos se consideran true si al menos están presentes en el elemento, independientemente de su value actual; como regla, se debería especificar una cadena de texto vacía ("") en value (algunas personas utilizan el nombre del atributo; esto funciona pero no es un standard). Vea un ejemplo posterior para una demostración práctica.

Dado que value se convierte en una cadena de texto, indicando null no necesariamente hace lo que se espera. En lugar de eliminar el atributo o establecer su valor para ser null, establece el valor del atributo a la cadena de texto "null". Si se desea eliminar un atributo, se debe llamar a removeAttribute().

undefined.

InvalidCharacterError

El atributo especificado name contiene uno o más caracteres que no son válidos en el nombre del atributo.

En el siguiente ejemplo, setAttribute() se utiliza para establecer atributos en un <button>.

var b = document.querySelector("button");

b.setAttribute("name", "helloButton");
b.setAttribute("disabled", "");

Esto demuestra dos cosas:

• La primera llamada a setAttribute() muestra cómo se cambia el valor del atributo name a "helloButton". Puede ver esto utilizando el inspector de página de su navegador (Chrome, Edge, Firefox, Safari).
• Para establecer el valor de un atributo booleano, como disabled, se puede especificar cualquier valor. Una cadena de texto vacía o el nombre de un atributo son valores recomendados. Todo lo que importa es que si el atributo está presente, independientemente de su valor actual, su valor se considera como true. La ausencia del atributo significa que su valor es false. Estableciendo una cadena vacía ("") como el valor del atributo disabled, se estaría cambiando disabled a true, lo que provoca que el botón sea deshabilitado.