Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

summary — rótulo de uma secção expansível

O elemento `summary` descreve uma secção `details` e permite expandi-la ou recolhê-la sem JavaScript.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<details>
  <summary>Label</summary>
  <p>Additional information.</p>
</details>

Coloque summary como primeiro filho de details. Serve de rótulo para o conteúdo restante. Só o primeiro filho summary desempenha esta função.

A ativação alterna o atributo open do elemento details pai, não um atributo de summary. Sem open, só o rótulo está visível; com esse atributo, o conteúdo adicional também fica visível. Escrever open="false" significa, ainda assim, que o atributo está presente e que a secção está aberta.

O conteúdo de summary pode ser conteúdo de frase, opcionalmente intercalado com títulos. São necessárias ambas as etiquetas. O elemento suporta atributos globais e utiliza HTMLElement; não é um botão autónomo de uso geral.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Summary example</title>
</head>
<body>
  <details>
    <summary>Answer</summary>
    <p>42</p>
  </details>
</body>
</html>

Resultado

Initially: Answer
After activating Answer: Answer and 42
After activating Answer again: Answer

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes