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

CKTIS / JavaScript

Element: clases, contenido y presencia de atributos

Usa `className` para leer o sustituir la cadena de clases, `innerHTML` para leer o sustituir el contenido como marcado y `toggleAttribute()` para cambiar la presencia de un atributo.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

element.className
element.className = classNames
element.innerHTML
element.innerHTML = markup
element.toggleAttribute(name)
element.toggleAttribute(name, force)

Estas son API del DOM, no funciones de ECMAScript 2024. La versión de ECMAScript indicada en esta entrada no determina su disponibilidad. Requieren un entorno que proporcione las API del DOM correspondientes; la compatibilidad depende del entorno de ejecución.

En un elemento HTML, className refleja el atributo class como una cadena de nombres de clases separados por espacios en blanco. Una asignación sustituye toda la cadena. Para cambiar una clase sin alterar las demás, usa classList. En un elemento SVG, className puede ser un SVGAnimatedString; usa getAttribute('class') o setAttribute('class', value) para trabajar directamente con el atributo.

Al leer innerHTML obtienes el marcado HTML o XML del contenido, sin incluir el propio elemento ni su raíz de sombra. Al asignarle un valor, el marcado se analiza en el contexto del elemento y sustituye los nodos del contenido en vez de añadir otros al final. En template se sustituye el contenido de la plantilla. Los escuchadores de eventos permanecen en los nodos antiguos y no se transfieren a los nuevos. En un documento XML, el marcado mal formado puede provocar SyntaxError al escribir, y un fallo de serialización puede provocar InvalidStateError al leer.

No pases marcado no confiable directamente a innerHTML: no lo sanea de forma predeterminada y eso supone un riesgo de XSS. Usa textContent para mostrar texto sin formato en elementos como span. No asignes texto no confiable a textContent en un elemento script: ese texto puede ejecutarse como código al insertar el elemento en el documento. Si necesitas marcado, sanea la entrada no confiable antes de insertarla. Si la CSP exige Trusted Types y no hay una política predeterminada, asignar una cadena normal lanza TypeError; usa TrustedHTML de una política adecuada.

toggleAttribute(name) elimina un atributo existente o añade uno ausente con un valor vacío. Con force, true garantiza la presencia sin alterar un valor existente y false garantiza la ausencia. El resultado booleano indica si el atributo está presente después de la llamada, no si hubo un cambio. En un atributo booleano HTML como disabled, ni siquiera el valor "false" lo desactiva: lo que cuenta es la presencia. En un elemento HTML de un documento HTML, las letras ASCII del nombre se convierten en minúsculas; un nombre no válido lanza InvalidCharacterError.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Element DOM example</title>
</head>
<body>
  <script>
    (() => {
      const button = document.createElement('button');
      button.className = 'action muted';
      button.className = 'action ready';

      button.innerHTML = '<span>Draft</span>';
      const oldLabel = button.firstElementChild;
      button.innerHTML = '<strong>Save</strong>';

      console.log(button.className);
      console.log(button.innerHTML);
      console.log(oldLabel.parentNode === null);
      console.log(button.toggleAttribute('disabled'));
      console.log(button.toggleAttribute('disabled', true));
      console.log(button.toggleAttribute('disabled', false));
    })();
  </script>
</body>
</html>

Resultado

action ready
<strong>Save</strong>
true
true
true
false

Guarda el ejemplo como un archivo HTML, ábrelo en un navegador que no exija Trusted Types y consulta la consola de desarrollo. El botón no se añade al documento. El primer `true` confirma que el nodo anterior de la etiqueta quedó separado; los tres últimos resultados muestran el estado de `disabled` tras añadirlo, garantizar su presencia y eliminarlo.

Lecciones relacionadas

  • JavaScript · Lección 39 · Intermedio · Versión: 3

Fuentes