Acordeão em CSS Puro (FAQ)
Um componente de acordeão (FAQ) altamente acessível, construído exclusivamente com elementos HTML details e summary e CSS, sem a necessidade de JavaScript.
Aproveitando os elementos semânticos <details> e <summary> introduzidos no HTML5, é possível criar um componente de acordeão funcional sem a necessidade de escrever uma única linha de JavaScript. Esta abordagem não apenas favorece o SEO, como também assegura total compatibilidade com a navegação por teclado (acessibilidade) de forma nativa.
Demonstração
Quais são as características deste acordeão?
É construído apenas com funcionalidades padrão do HTML e CSS, sem o uso de JavaScript. É muito leve e excelente para SEO e acessibilidade (suporte a operação por teclado, etc.).
Posso abrir vários itens ao mesmo tempo?
Ao definir o atributo name com o mesmo valor (neste exemplo, name=“faq”), é possível ter controle exclusivo onde, ao abrir um item, os outros se fecham automaticamente. Se quiser abrir vários ao mesmo tempo, remova o atributo name.
Como as animações são implementadas?
A animação de rotação do ícone e o efeito de fade-in do conteúdo são implementados usando transition e @keyframes do CSS.
Código
<div class="accordion-container">
<details class="accordion" name="faq">
<summary class="accordion-summary">
Quais são as características deste acordeão?
<span class="icon"></span>
</summary>
<div class="accordion-content">
<p>É construído apenas com funcionalidades padrão do HTML e CSS, sem o uso de JavaScript. É muito leve e excelente para SEO e acessibilidade (suporte a operação por teclado, etc.).</p>
</div>
</details>
<details class="accordion" name="faq">
<summary class="accordion-summary">
Posso abrir vários itens ao mesmo tempo?
<span class="icon"></span>
</summary>
<div class="accordion-content">
<p>Ao definir o atributo name com o mesmo valor, o controle exclusivo (abrir um fecha os outros) é possível.</p>
</div>
</details>
</div>/* Estilização do contêiner */
.accordion-container {
display: flex;
flex-direction: column;
gap: 1rem;
width: 100%;
max-width: 600px;
margin: 0 auto;
}
/* Corpo do acordeão */
.accordion {
border: 1px solid #e2e8f0;
border-radius: 8px;
background-color: #ffffff;
overflow: hidden;
box-shadow: 0 1px 3px rgba(0,0,0,0.05);
}
/* Estilização do sumário (título) */
.accordion-summary {
padding: 1.25rem 1.5rem;
font-weight: 600;
font-size: 1.05rem;
cursor: pointer;
display: flex;
justify-content: space-between;
align-items: center;
list-style: none; /* Oculta a marca de triângulo padrão */
color: #1e293b;
transition: background-color 0.2s ease;
user-select: none;
}
/* Oculta a marca de triângulo padrão para Safari */
.accordion-summary::-webkit-details-marker {
display: none;
}
.accordion-summary:hover {
background-color: #f8fafc;
}
/* Sublinhado no sumário quando aberto */
.accordion[open] .accordion-summary {
border-bottom: 1px solid #e2e8f0;
}
/* Estilização do ícone de abrir/fechar */
.icon {
position: relative;
width: 20px;
height: 20px;
display: flex;
align-items: center;
justify-content: center;
flex-shrink: 0;
margin-left: 1rem;
}
/* Linhas horizontal e vertical do ícone */
.icon::before,
.icon::after {
content: '';
position: absolute;
background-color: #64748b;
transition: transform 0.3s cubic-bezier(0.4, 0, 0.2, 1);
border-radius: 2px;
}
.icon::before {
width: 16px;
height: 2px;
}
.icon::after {
width: 2px;
height: 16px;
}
/* Animação quando o acordeão é aberto (+ vira -) */
.accordion[open] .icon::after {
transform: rotate(90deg) scaleY(0);
}
.accordion[open] .icon::before {
background-color: #3b82f6;
}
/* Estilização da parte do conteúdo */
.accordion-content {
padding: 1.5rem;
color: #475569;
line-height: 1.6;
animation: fadeDown 0.3s ease-out forwards;
}
.accordion-content p {
margin: 0;
}
/* Animação de exibição suave */
@keyframes fadeDown {
from {
opacity: 0;
transform: translateY(-10px);
}
to {
opacity: 1;
transform: translateY(0);
}
} Pontos de Implementação
- Uso dos elementos
<details>e<summary>: Sua adoção permite que a mecânica de expandir e recolher funcione nativamente, eliminando a dependência de scripts para eventos de clique e gerenciamento de estado. - Ocultar a seta padrão do navegador:
Aplicando
list-style: none;e::-webkit-details-marker { display: none; }, o ícone triangular nativo é suprimido, permitindo a substituição por um indicador personalizado de design superior. - Controle exclusivo via atributo
name: Ao atribuir o mesmo valor ao atributonameem múltiplos elementos<details>, garante-se que, ao abrir um painel, os demais se fechem automaticamente. Este comportamento clássico de acordeão agora é suportado nativamente pelo HTML (funcionalidade introduzida recentemente nas especificações). - Animações em CSS:
O efeito de fade-in ao expandir (
@keyframes) e a transição do ícone de adição (+) para subtração (-) (transition) são orquestrados inteiramente via CSS, proporcionando uma experiência de usuário enriquecida e fluida.