Fecha: 2026-11-19 - San Abdón   Calendario 2026  | Info

Blog Blog

Cómo utilizar las etiquetas details y summary en HTML

Autor: Manuel E. Toledo   |   Comentarios: 0

Las etiquetas <details><details> y<summary> forman parte de HTML5 y permiten crear secciones desplegables sin necesidad de JavaScript. Son ideales para preguntas frecuentes (FAQ), información adicional, tutoriales, documentación técnica y cualquier contenido que quieras mostrar u ocultar bajo demanda.

¿Qué son details y summary?

La etiqueta <details> actúa como un contenedor desplegable, mientras que <summary> define el título o encabezado que el usuario debe pulsar para mostrar u ocultar el contenido.

Ejemplo básico

HTML
    <details>
    <summary>¿Qué es HTML?</summary>
    <p>HTML es el lenguaje estándar para crear páginas web.</p>
    </details>

Resultado

  • El usuario verá únicamente el texto "¿Qué es HTML?".
  • Al hacer clic sobre él, aparecerá el contenido oculto.
  • Al volver a pulsar, el contenido se ocultará de nuevo.

Mantener una sección abierta por defecto

Si deseas que el contenido aparezca desplegado inicialmente, utiliza el atributo open.

HTML
    <details open>
    <summary>Información importante</summary>
    <p>Esta sección aparece abierta por defecto.</p>
    </details>

Aplicando estilos CSS

Aunque el navegador proporciona un diseño básico, podemos personalizar completamente la apariencia.

Estilo básico

HTML
    <details class="acordeon">
    <summary>Ver más información</summary>
    

Contenido desplegable.</p> </details>

CSS
    .acordeon {
    border: 1px solid #ddd;
    border-radius: 5px;
    padding: 10px;
    margin-bottom: 15px;
    background: #f8f9fa;
    }
     
    .acordeon summary {
    font-weight: bold;
    cursor: pointer;
    color: #0d6efd;
    }

Explicación

  • border: añade un borde
  • border-radius: redondea las esquinas.
  • cursor: pointer: muestra la mano al pasar el ratón.
  • font-weight: bold: resalta el texto del resumen.

Cambiar el color cuando está abierto

Puedes detectar si el elemento está desplegado mediante el atributo open.

CSS
    .acordeon[open] {
    background: #e9f5ff;
    border-color: #0d6efd;
    }
     
    .acordeon[open] summary {
    color: #084298;
}

Eliminar el icono nativo del navegador

Algunos navegadores muestran un triángulo automáticamente.

CSS
    summary {
    list-style: none;
    }
     
    summary::-webkit-details-marker {
    display: none;
    }

Crear un icono personalizado

HTML
    <details class="faq">
    <summary>
    <span class="icono">+</span>

    ¿Cómo funciona Details?
    </summary>
     
    <

Permite ocultar y mostrar contenido sin JavaScript.</p> </details>

CSS
    .faq summary {
    cursor: pointer;
    font-weight: 600;
    display: flex;
    align-items: center;
    gap: 10px;
    }
     
    .faq .icono {
    width: 20px;
    text-align: center;
    transition: transform .3s ease;
    }
     
    .faq[open] .icono {
    transform: rotate(45deg);
    }

Cuando el bloque se abre, el signo "+" rota y se convierte visualmente en una "×".

Añadir animaciones

Las etiquetas <details> no admiten transiciones de altura de forma nativa, pero podemos conseguir un efecto visual agradable.

CSS
    details p {
    animation: aparecer .3s ease;
    }
     
    @keyframes aparecer {
    from {
    opacity: 0;
    transform: translateY(-5px);
    }
     
    to {
    opacity: 1;
    transform: translateY(0);
    }
    }

Ejemplo completo de FAQ profesional

Ver ejemplo en funcionamiento

HTML
    <div class="faq-container">
     
    <details class="faq-item">
    <summary>¿Qué es HTML?</summary>
    

HTML es el lenguaje de marcado utilizado para crear páginas web.</p> </details>   <details class="faq-item"> <summary>¿Qué es CSS?</summary> <p>CSS permite dar formato y diseño a los documentos HTML.</p> </details>   <details class="faq-item"> <summary>¿Necesito JavaScript para usar Details?</summary>

No. Details y Summary funcionan de forma nativa en los navegadores modernos.</p> </details>   </div>

CSS
    .faq-container {
    max-width: 800px;
    margin: 0 auto;
    }
     
    .faq-item {
    margin-bottom: 15px;
    border: 1px solid #dee2e6;
    border-radius: 8px;
    overflow: hidden;
    }
     
    .faq-item summary {
    padding: 15px;
    background: #f8f9fa;
    cursor: pointer;
    font-weight: 600;
    transition: background .3s;
    }
     
    .faq-item summary:hover {
    background: #e9ecef;
    }
     
    .faq-item p {
    padding: 15px;
    margin: 0;
    }
     
    .faq-item[open] summary {
    background: #0d6efd;
    color: white;
    }

Ventajas de usar details y summary

 ✅ No requieren JavaScript.
 ✅ Mejoran la accesibilidad.
 ✅ Son compatibles con la mayoría de navegadores modernos.
 ✅ Ideales para FAQs, manuales y documentación técnica.
 ✅ Permiten aplicar estilos CSS personalizados.
 

Conclusión

Las etiquetas <details> y <summary> son una solución sencilla, accesible y eficiente para crear acordeones y bloques de contenido desplegable. Con unas pocas reglas CSS puedes transformar su apariencia básica en componentes modernos y profesionales, perfectos para páginas de ayuda, preguntas frecuentes o documentación técnica.


Su Comentario:

Deje aquí su comentario acerca de este artículo...


Otros artículos del blog

Adapta tu sitio web a la nueva normativa sobre cookies
Atributo download HTML5 para descargar archivos del servidor mediante enlaces
Botón redondeado con CSS
Bucle para recibir todas las variables por POST en PHP
Carga o upload de archivos con CodeIgniter
Columnas Múltiples con CSS3: Guía Completa para Crear Diseños Profesionales
Como evitar la inyección SQL en PHP
Cómo optimizar la etiqueta de título para atraer más tráfico de Google
Como puedo abrir puertos en mi router para acceder remotamente a mi ordenador personal
Cómo utilizar las etiquetas <details> y <summary> en HTML y aplicar estilos con CSS
Cómo utilizar las etiquetas details y summary en HTML
Contador de caracteres con JQuery
Copias de seguridad avanzadas para bases de datos MySQL
Crear un sticky desplegable en la web
Cuánto cuesta desarrollar un sitio web en España: guía completa de precios en 2026
Detectar el sistema operativo, navegador y versión del cliente
Diseño y desarrollo web a la medida
Ejecutar script automáticamente con Cron en Linux
El elemento meter HTML5
El filtro Blur (desenfoque) en CSS y alguno de sus posibles usos
El filtro Blur (desenfoque) en CSS y alguno de sus posibles usos
El nuevo elemento <picture> de HTML5 para crear imágenes responsive
Elementos fundamentales para trabajar con Codeingniter
Envío de correos o emails con CodeIgniter, guía rápida
Función para extraer la extensión de un archivo con PHP
Guía rápida sobre el elemento br en HTML
Guía rápida sobre el elemento p en HTML
Guía rápida sobre los bordes en CSS
La Clase Database en CodeIgniter 3: Guía Básica y Ejemplo CRUD
La clase DATABASE en Codeigniter de 0 a 100
La etiqueta meta viewport en html5
La relación entre el contenido extenso y el convencimiento del usuario
Las fuentes de Google Font para nuestra web y efectos sobre nuestras fuentes
Lo bueno y lo malo del SEO
Los helpers en CodeIgniter para definir nuestras funciones
Mensaje aceptar cookies para cumplir con la Ley General de Protección de Datos (LGPD)
Meta tags de HTML
Múltiples bordes en un contenedor con CSS
Script para automatizar backups de MySQL en servidores Windows
Streams en PHP
Trucos y ejemplos de configuración del archivo htaccess de Apache
Uso de las páginas de error 404 como soporte estratégico de contenidos
¿Cómo crear una API REST con CodeIgniter?
¿Cómo redimensionar imágenes con CodeIgniter?
¿Qué documentos necesitas para solicitar la ayuda como emigrante retornado?
¿Qué es y para qué sirve un archivo robots.txt?