Zum Inhalt springen

Suche

Das <details>-Element ohne JavaScript animieren

CSSA11yPerformance

Mit interpolate-size und ::details-content klappt das <details>-Element weich auf und zu. Browser ohne Unterstützung öffnen es sofort, wie bisher.

von
6 Min. Lesezeit

Warum konnten wir nie zu height: auto animieren? Weil CSS nicht zwischen einer Länge und einem Schlüsselwort rechnen kann. Für ein Akkordeon hieß das bisher: Entweder springt es auf, oder wir messen den Inhalt mit JavaScript.

TL;DR

Mit interpolate-size: allow-keywords freischalten, height auf ::details-content animieren und content-visibility mit allow-discrete überblenden, damit auch das Zuklappen animiert. Alles in @supports und prefers-reduced-motion packen. Alle anderen Browser öffnen <details> sofort, wie bisher.

Warum height: auto nie animiert hat

Eine Transition braucht zwei Werte, zwischen denen sie rechnen kann. 0 und 300px gehen. 0 und auto gehen nicht, weil auto erst beim Layout aufgelöst wird. Der Browser animiert deshalb gar nicht, er schaltet um.

Wir haben uns dafür drei Arten von Umwegen gebaut:

  • max-height mit großzügigem Wert. Die Transition läuft bis zum Maximalwert, nicht bis zur echten Höhe. Das Zuklappen beginnt mit spürbarer Verzögerung, weil der erste Teil der Transition oberhalb des Inhalts passiert.
  • Messen mit JavaScript. scrollHeight auslesen, als Pixelwert setzen, animieren, zurücksetzen. Das funktioniert, braucht aber ein Skript und bricht, sobald sich der Inhalt nach dem Messen ändert.
  • grid-template-rows von 0fr auf 1fr. Reines CSS und recht robust, braucht aber ein zusätzliches Wrapper-Element um den Inhalt.

Alle drei umgehen das Symptom. Keiner lässt den Browser tun, was er ohnehin weiß: wie hoch der Inhalt ist.

Freischalten mit interpolate-size

Seit Chrome 129 erlaubt interpolate-size: allow-keywords Animationen zu und von auto, min-content, max-content und fit-content. Dass wir das ausdrücklich einschalten müssen, hat einen Grund: Viele bestehende Seiten verlassen sich darauf, dass diese Schlüsselwörter nicht animieren. Für alle eingeschaltet, würde es sie kaputt machen.

Die Eigenschaft wird vererbt. Die meisten Beispiele setzen sie einmal auf :root. Ich setze sie lieber an die Komponente, die sie braucht:

accordion.css
.accordion {
  interpolate-size: allow-keywords;
}

Warum so eng? Auf :root animiert plötzlich jede bestehende Transition, die height oder width berührt und dabei auf auto trifft. Vielleicht ist das genau gewollt. Auf einer über Jahre gewachsenen Seite ist es eine Änderung, die wir bewusst machen sollten, Komponente für Komponente.

Daneben gibt es calc-size(), wenn wir mit einer intrinsischen Größe rechnen müssen, etwa calc-size(auto, size + 2rem). Für reine Animationen reicht interpolate-size. Eine Grenze gilt für beide: Zwischen zwei Schlüsselwörtern lässt sich nicht animieren. Ein Ende muss eine Länge oder ein Prozentwert sein.

Auf- und Zuklappen mit ::details-content

<details> versteckt seinen Inhalt selbst, und lange konnten wir am versteckten Teil nichts gestalten. ::details-content ändert das. Es wählt alles in <details> außer dem <summary> aus und funktioniert in Chrome 131, Firefox 143 und Safari 18.4.

Das Aufklappen ist der leichte Teil: height geht von 0 auf auto. Das Zuklappen ist kniffliger. Schließt sich <details>, versteckt der Browser den Inhalt sofort mit content-visibility: hidden, und von der Animation wäre nichts zu sehen. Eine Transition auf content-visibility mit allow-discrete hält den Inhalt sichtbar, bis height bei 0 angekommen ist.

Das Akkordeon auf dieser Seite nutzt dasselbe CSS, nur mit eigenen Klassennamen:

accordion.css
@supports (interpolate-size: allow-keywords) {
  @media (prefers-reduced-motion: no-preference) {
    .accordion {
      interpolate-size: allow-keywords;
    }

    .accordion__item::details-content {
      height: 0;
      overflow: clip;
      transition:
        height 200ms ease,
        content-visibility 200ms ease allow-discrete;
    }

    .accordion__item[open]::details-content {
      height: auto;
    }
  }
}

Achtung: height: 0 gehört in @supports

Firefox und Safari unterstützen ::details-content schon, interpolate-size aber noch nicht. Steht height: 0 außerhalb des @supports-Blocks, bleibt der Inhalt in diesen Browsern auf null Höhe und ist nicht mehr lesbar.

Das Beispiel in Bramus’ Artikel zum Gestalten von <details> löst das mit einem Fallback: einer festen Höhe von 150px und einem Scrollbalken. Ich lasse Browser ohne Unterstützung lieber tun, was <details> schon immer getan hat, und sofort aufklappen. Die Animation ist eine Verbesserung, keine Funktion, von der der Inhalt abhängt.

Probier es hier aus. Mit reduzierter Bewegung in den Systemeinstellungen öffnen sich die Abschnitte ohne Animation:

Ändert sich etwas für die Tastatur?

Nein. <summary> behält seine Rolle und seinen Zustand, Enter und Leertaste klappen weiter auf und zu. Die Animation ändert nur, wie der Inhalt erscheint.

Was passiert bei der Suche auf der Seite?

In Chromium-Browsern öffnen die Suche auf der Seite, Text-Fragmente und Links auf ein Element im Inhalt weiterhin den passenden Abschnitt, und die Animation läuft beim Öffnen mit.

Warum 200 Millisekunden?

Lang genug, um zu sehen, woher der Inhalt kommt, kurz genug, um niemanden aufzuhalten. Das Pfeil-Icon dieser Komponente dreht sich in 150 ms, so wirken beide Bewegungen zusammengehörig.

Support, Fallback und Kosten

Browser-Support, Stand 22. Oktober 2026
Feature Chrome und Edge Firefox Safari
interpolate-size 129 noch nicht, positiv Technology Preview 254
calc-size() 129 noch nicht Technology Preview 254
::details-content 131 143 18.4

Safari Technology Preview 254 hat beide Features am 8. Oktober 2026 ausgeliefert. Mozilla hat eine positive Standards-Position und einen offenen Bug. Bis beide stabil sind, bekommen die meisten Besucher in Safari und Firefox die Variante ohne Animation, und die ist völlig in Ordnung.

Die Animation hat einen Preis. height löst in jedem Frame ein Layout aus, und der web.dev-Leitfaden zu Animationen ist da deutlich:

Avoid any property that triggers layout or paint unless it’s absolutely necessary.

— web.dev: How to create high-performance CSS animations

Für eine Handvoll kurzer Abschnitte halte ich das für vertretbar. Bei einer langen FAQ mit schwerem Inhalt lohnt sich vorher eine Messung im Performance-Panel mit CPU-Drosselung. Brechen die Frames ein, ist ein reines Einblenden über opacity auf ::details-content die günstigere Alternative.

Fazit

Ein weich aufklappendes <details> brauchte bisher JavaScript oder einen Umweg. Heute reichen ein paar Zeilen CSS, und Browser ohne Unterstützung verlieren nichts. Gibt es in deinem Projekt eine Komponente, die Höhen mit JavaScript misst und stattdessen ein <details> sein könnte?

Zum Weiterlesen

Geschrieben von

Oliver Scheffler

Ich baue seit 25 Jahren Websites und schreibe hier über Frontend, Barrierefreiheit und Performance – meistens über Dinge, an denen ich mir selbst die Zähne ausgebissen habe.

Barrierefreie Tabs, mit CSS, das den Zustand liest

A11yJavaScriptCSS

Das ARIA-Pattern für Tabs wirkt klein, steckt aber voller Entscheidungen. Hier sind Markup, Tastatur-Code und ein CSS, das nicht von dem abweichen kann, was Screenreader hören, mit einer Position zu jedem strittigen Punkt.

10 Min. Lesezeit