HTML/Elemente/details

Das details-Element ermöglicht den Benutzern einer Webseite, zu einem Kurztext ergänzende Teile einblenden zu lassen. Dabei kann es sich im summary-Element um Text, Bilder oder auch weitere Bedienelemente der Webseite wie z.B. ein Untermenü handeln.

Syntax

Start-Tag: notwendig

End-Tag: notwendig

WAI‑ARIA‑Rolle

Elternelemente

Darf vorkommen in:

• Elementen mit flow content

erlaubte Inhalte

• ein summary-Element
• gefolgt von beliebig viel flow content

Beispiel

<details>
  <summary> Update News: </summary>
  <p> Das details-Element ermöglicht es, ganz ohne den Einsatz von JavaScript,
      ursprünglich verborgene Textinhalte aufzuklappen.
  </p> 
</details>

Das details-Element enthält eine Summary, deren Text angezeigt wird. Mit einem Klick auf den Text (oder den im Shadow-Dom verborgenen - aber sichtbaren - Marker) wird das p-Element auf- und zugeklappt.

Beachten Sie: Das summary-Element ist optional. Wenn es fehlt, wird den Benutzern ein browserspezifischer Hinweis auf den aufklappbaren Bereich angezeigt. Ist es vorhanden, muss es das erste Kindelement des details-Elements sein.

Attribute

Name	Inhalt	Standardwert	Bedeutung
Universalattribute
id	ID		identifiziert ein einziges Element innerhalb eines Dokuments
class	CDATA		ordnet ein Element einer oder mehreren Klassen zu.
accesskey	ID		Tastaturkürzel
contenteditable	CDATA		editierbarer Inhalt
contextmenu			definiert Kontextmenü
dir	ltr, rtl		definiert die Schreibrichtung innerhalb des Dokuments
draggable	ID		kann mit Drag & Drop gezogen werden
dropzone	CDATA		Aktion bei Ablegen
hidden			versteckter Inhalt
lang	NAME		legt eine den IANA-Sprachdefinitionen folgende Sprache des Elementinhalts fest [RFC1766]
spellcheck	ID		Rechtschreibprüfung Sollte auch für input type="password" deaktiviert werden.
style	CDATA		notiert direkt in einem Element- style sheet data
tabindex	NAME		zeigt an, ob dieses Element fokusiert werden kann, ob es mithilfe der Tastaturnavigation angesteuert werden kann und in welcher Reihenfolge navigiert wird.
title	CDATA		betitelt oder beschreibt ein Element.
open	Boolesches Attribut		Bestimmt, wenn dieses Attribut gesetzt wurde, dass die verborgenen Informationen, nach dem Laden der Seite, angezeigt werden. Anderfalls bleiben sie verborgen.

Attribut: Pflichtattribut
Attribut: optionales Attribut

Siehe auch

• Infobox (Offenlegungs-Widgets in HTML)
  • Infobox/Akkordeon mit details
    • Exklusives Akkordeon
    • Registerkarten
• Navigation/Flyout-Menü
  Alternative mit details

Weblinks

• Spezifikation (W3C): The details-Element