Resumo

  • details e summary formam um painel de divulgação que o navegador abre ou fecha quando o leitor pede.
  • O atributo name reúne painéis em um acordeão exclusivo: abrir um deles fecha outro do mesmo grupo.

Página comprida pode virar gaveta despejada sobre a mesa: instruções, opções e minúcias disputam o mesmo espaço. Os autores sempre puderam escrever código para recolher um trecho. O HTML resolveu oferecer uma dobradiça de fábrica. Coloque um <summary> no começo de <details>; o navegador mostra a placa e cuida da abertura. O leitor segura a maçaneta. Parece um detalhe, com trocadilho inevitável, mas muda a experiência de quem procura uma informação específica.

O primeiro rascunho público de marcação HTML do W3C, de março de 2010, marcou details e summary como elementos novos. Chamou details de controle para obter informações adicionais sob demanda e apresentou o atributo booleano open. O texto registra uma decisão clara: o conteúdo continua no documento, enquanto sua abertura passa a ter uma forma reconhecida pela própria linguagem.

A referência do W3C de 2011 manteve o arranjo. A legenda vem primeiro; open determina se o restante aparece. A relação entre placa e conteúdo fica no HTML, sem depender inteiramente de um programa escondido em outro arquivo. O autor ainda escolhe o que guardar ali e como anunciar. Uma placa dizendo “Mais” parece econômica, até o visitante precisar abrir três portas para descobrir qual delas contém as opções de transferência.

O padrão HTML mantido hoje detalha a manobra. O primeiro summary é a legenda; se faltar, o navegador deve oferecer uma. Sem open, só a legenda aparece; com open, o conteúdo também. Ao atender ao pedido do usuário, o navegador adiciona ou remove o atributo. Há ainda o evento toggle para sinalizar a troca de estado. Documento, tela e gesto do leitor formam um mecanismo curto e inteligível.

Até o triângulo junto da legenda ganha instruções nas regras de renderização: há marca para fechado e marca para aberto. Sua discrição é a virtude. Ele indica onde agir e informa o resultado, como interruptor que dispensa manual. Relatórios de progresso, controles ocasionais e documentos extensos podem aproveitar a mesma convenção. A Web costuma se lembrar dos grandes palcos; é na pequena maçaneta que muita navegação acontece.

O padrão atual também permite que várias portas dividam um name. Quando uma se abre, outra do grupo se fecha. O navegador passa a montar um acordeão exclusivo sem que o autor vigie cada painel com um roteiro próprio. O próprio texto da norma alerta: essa arrumação pode atrapalhar quem precisa consultar duas seções abertas ao mesmo tempo. A página fica mais enxuta, mas a pessoa paga em idas e vindas. Até a ordem visual tem uma conta.

Esse controle distribui tarefas com precisão. O autor decide quais cômodos existem, o nome na porta e se as portas vizinhas devem se fechar. O navegador executa a abertura. O leitor escolhe entrar. A melhor versão anuncia exatamente o que guarda e permite manter à vista o que precisa ser comparado. O HTML forneceu a dobradiça; o bom senso editorial ainda escolhe onde pôr a porta.