Acciones del artículo<sumario>: el elemento de resumen de divulgaciónEl elemento HTML <sumario> especifica un resumen, un título o una leyenda para el cuadro de divulgación de un elemento <detalles>. Al hacer clic en el elemento <summary> se alterna el estado del elemento <details> padre abierto y cerrado.Pruébelo
Un elemento <summary> sólo puede utilizarse como primer hijo de un elemento <details>. Cuando el usuario hace clic en el resumen, el elemento <detalles> padre se abre o se cierra y, a continuación, se envía un evento de alternancia al elemento <detalles>, que puede utilizarse para avisar cuando se produce este cambio de estado.Texto de la etiqueta por defectoSi el primer hijo de un elemento <detalles> no es un elemento <sumario>, el agente de usuario utilizará una cadena por defecto (normalmente “Detalles”) como etiqueta para el cuadro de revelación.Estilo por defectoPor la especificación HTML, el estilo por defecto de los elementos <sumario> incluye display: list-item. Esto permite cambiar o eliminar el icono que se muestra como widget de divulgación junto a la etiqueta del valor predeterminado, que suele ser un triángulo.
El Lenguaje de Marcas de Hipertexto (HTML) es el conjunto de símbolos o códigos de marcas que se insertan en un archivo destinado a ser mostrado en Internet. Las marcas indican a los navegadores cómo mostrar las palabras e imágenes de una página web.
Cada pieza individual de código de marcado (que se encuentra entre los caracteres “<” y “>”) se denomina elemento, aunque mucha gente también se refiere a él como etiqueta. Algunos elementos vienen en pares que indican cuándo debe comenzar un efecto de visualización y cuándo debe terminar.
El lenguaje de marcado de hipertexto es el lenguaje informático que facilita la creación de sitios web. El lenguaje, que tiene palabras clave y sintaxis como cualquier otro lenguaje, es relativamente fácil de comprender y, con el paso del tiempo, cada vez más potente en lo que permite crear. El HTML sigue evolucionando para satisfacer las demandas y requisitos de Internet bajo la tutela del World Wide Web Consortium, la organización que diseña y mantiene el lenguaje; por ejemplo, con la transición a la Web 2.0.
El hipertexto es el método por el que los usuarios de Internet navegan por la web. Al hacer clic en un texto especial llamado hipervínculo, los usuarios son conducidos a nuevas páginas. El uso de hipertexto significa que no es lineal, por lo que los usuarios pueden ir a cualquier parte de Internet simplemente haciendo clic en los enlaces disponibles. El marcado es lo que las etiquetas HTML hacen al texto dentro de ellas; lo marcan como un tipo específico de texto. Por ejemplo, el texto marcado puede aparecer en forma de negrita o cursiva para llamar la atención sobre una palabra o frase.
El elemento tabla de HTML 4 admitía un atributo, summary, cuyo objetivo era proporcionar información de alto nivel sobre la tabla a los usuarios que no podían verla. Esta propuesta de cambio sugiere sustituir el atributo summary del elemento tabla por el elemento details que ya está en HTML 5. Añade algunas características al elemento details para dar soporte a casos de uso exclusivos de la accesibilidad de las tablas para los usuarios que no pueden ver. Se permitiría que el atributo summary quedara obsoleto, pero seguiría siendo conforme hasta una futura versión de HTML, para permitir la retrocompatibilidad con agentes de usuario anteriores a HTML 5.
El caso de uso de la información de la descripción de la tabla sigue existiendo, pero hay una gran preocupación por que siga existiendo en el atributo summary. En general, es mejor poner el texto en los elementos que en los atributos, para que sea más fácil de encontrar para los desarrolladores y localizadores. También preocupa el hecho de que el resumen no se presente en la representación visual de la página, y que esto cause problemas de usabilidad a los autores y desarrolladores, que o bien no proporcionan el texto del resumen, o bien permiten que una herramienta rellene automáticamente el texto del resumen, y/o permiten que el texto del resumen se quede obsoleto.
El elemento HTML Disclosure Summary (<summary>) especifica un resumen, título o leyenda para el cuadro de divulgación de un elemento <details>. Al hacer clic en el elemento <summary> se alterna el estado del elemento <details> padre abierto y cerrado.
El código fuente de este ejemplo interactivo está almacenado en un repositorio de GitHub. Si quieres contribuir al proyecto de ejemplos interactivos, clona https://github.com/mdn/interactive-examples y envíanos un pull request.
Un elemento <summary> sólo puede utilizarse como primer hijo de un elemento <details>. Cuando el usuario hace clic en el resumen, el elemento <detalles> padre se abre o se cierra, y entonces se envía un evento de alternancia al elemento <detalles>, que puede utilizarse para avisar cuando se produce este cambio de estado.
Según la especificación HTML, el estilo por defecto de los elementos <summary> incluye display: list-item. Esto permite cambiar o eliminar el icono que se muestra como widget de divulgación junto a la etiqueta del predeterminado, que suele ser un triángulo.