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	Token		ordnet ein Element einer oder mehreren Klassen zu.
accesskey	Text (string)		Tastaturkürzel
contenteditable	Boolean		editierbarer Inhalt
dir	ltr, rtl		definiert die Schreibrichtung innerhalb des Dokuments
draggable	Boolean		kann mit Drag & Drop gezogen werden
hidden		Boolean	versteckter Inhalt
lang	Sprachkürzel		legt eine den IANA-Sprachdefinitionen folgende Sprache des Elementinhalts fest [RFC1766]
spellcheck	Boolean		Rechtschreibprüfung Sollte auch für input type="password" deaktiviert werden.
style	String (Text)		notiert direkt in einem Element- style sheet data
tabindex	NUMBER		zeigt an, ob dieses Element fokusiert werden kann, ob es mithilfe der Tastaturnavigation angesteuert werden kann und in welcher Reihenfolge navigiert wird.
title	String (Text)		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