HTMLWiki.de: summary
HTMLWiki.de >
HTML lernen • Beispiele • Tutorials • KI

[ START ] [ TUTORIAL ] [ HTML ] [ CSS ] [ KI ] [ SPIELWIESE ] [ SITEMAP ]

Das summary-Element: Der sichtbare Teil der Klappe

Das <summary> ist die immer sichtbare, anklickbare Kopfzeile eines details-Elements. Es existiert ausschließlich in dieser Rolle: außerhalb von details hat es keine Funktion und keine Berechtigng.

Syntax

HTML-Code

<details>
    <summary>Systemvoraussetzungen anzeigen</summary>
    <ul>
        <li>Ein Browser</li>
        <li>Das war es schon</li>
    </ul>
</details>

Die Regeln

  • Das summary steht als erstes Kind direkt im details, nicht weiter unten und nicht in einen div gewickelt.
  • Pro details gibt es genau ein summary. Fehlt es, spendiert der Browser eine Standardbeschriftung ("Details"), die niemandem etwas sagt.
  • Der Text sollte wie eine gute Überschrift funktionieren: Er verrät was hinter der Klappe wartet. "Mehr anzeigen" ist so nichtssagend wie "hier klicken" bei Links.

Gestalten und Feintuning

Das Dreieck-Symbol lässt sich per CSS gestalten oder entfernen (über den Listen-Marker des summary), und der Cursor darf ruhig per cursor: pointer signalisieren dass hier geklickt werden kann. Innerhalb des summary sind auch Inline-Elemente erlaubt, etwa ein <strong> oder ein kleines Icon. Überschriften-Elemente hineinzusetzen ist zwar technisch möglich, bringt aber verwirrende Doppelrollen in die Gliederung, meist fährt man mit schlichtem Text besser.

Typische Fehler

  • Interaktives im summary. Ein Link oder Button in der Klappzeile führt zu Klick-Konflikten: Was gilt jetzt, Aufklappen oder Link? Interaktive Elemente gehören in den Inhalt darunter.
  • summary als schicke Box zweckentfremden, ohne details drumherum. Dafür gibt es div und CSS.
  • Die Klappzeile nur mit JavaScript-Logik nachbauen. Das Duo details/summary bringt Tastaturbedienung und Screenreader-Ansage gratis mit, selbstgebaute Lösungen müssen das alles nachliefernn.

Verwandt: details · dialog · Barrierefreiheit