WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

view-timeline — Kurzschreibweise für eine benannte View-Fortschrittsachse

Die Eigenschaft view-timeline deklariert auf einem Element eine benannte Fortschrittsachse, die von seiner Position in einem Scrollbereich abhängt. Sie kombiniert Name, Achse und Insets; eine Animation wird separat über animation-timeline damit verknüpft.

Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntax

view-timeline: [ <'view-timeline-name'> [ <'view-timeline-axis'> || <'view-timeline-inset'> ]? ]#;

view-timeline ist die Kurzschreibweise für view-timeline-name, view-timeline-axis und view-timeline-inset. Sie deklariert eine Timeline auf dem beobachteten Element, startet aber selbst keine Animation. Der Fortschritt hängt davon ab, wie das Element den Sichtbarkeitsbereich seines nächsten scrollenden Vorfahren durchläuft, nicht von der verstrichenen Zeit.

Der Name ist ein Bezeichner, der mit -- beginnt; none deklariert keine benannte Timeline. Die Standardwerte der Komponenten sind none, block und auto. Die Kurzschreibweise setzt ausgelassene Komponenten zurück. block und inline wählen logische Achsen, x und y physische Achsen. Kommas trennen mehrere Timelines; # in der Grammatik steht für eine solche Liste.

Optionale Insets akzeptieren einen oder zwei Werte: auto oder Längen/Prozentwerte. Ein Wert gilt für beide Enden; zwei Werte geben Anfang und Ende an. Positive Werte verkleinern den Sichtbarkeitsbereich, negative vergrößern ihn. Prozentwerte beziehen sich auf die Abmessung des Scrollports, während auto scroll-padding verwendet.

Im Beispiel verknüpft animation-timeline: --card die Animation mit der deklarierten Timeline. Setze diese Deklaration nach animation, da diese die Auswahl der Timeline zurücksetzt. Der standardmäßige vollständige Bereich reicht vom ersten Eintritt bis zum vollständigen Austritt. Das Beispiel wurde in einer isolierten Umgebung mit Chromium 157.0.8103.51 ausgeführt. Die Konsolenausgabe stimmte exakt mit der erwarteten Ausgabe überein. Eine CSS-Deklaration allein garantiert keine Browserunterstützung. Prüfe das Beispiel daher auch in deinem lokalen Browser.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Named view progress timeline</title>
  <style>
    .scroller {
      height: 200px;
      width: min(100%, 24rem);
      overflow-y: auto;
      writing-mode: horizontal-tb;
      border: 1px solid;
    }
    .space { height: 300px; }
    .subject { min-height: 100px; background: royalblue; color: white; }
    @supports (view-timeline: --card block) and (view-timeline-inset: 10% 20%) and (animation-timeline: --card) {
      .subject {
        view-timeline: --card block;
        view-timeline-inset: 10% 20%;
        animation: fade linear both;
        animation-duration: auto;
        animation-timeline: --card;
      }
    }
    @keyframes fade {
      from { opacity: 0.35; }
      to { opacity: 1; }
    }
  </style>
</head>
<body>
  <p>Scroll the panel to bring the card into view.</p>
  <div class="scroller" role="region" aria-label="View timeline demo" tabindex="0">
    <div class="space" aria-hidden="true"></div>
    <div class="subject">Timeline card</div>
    <div class="space" aria-hidden="true"></div>
  </div>
  <script>
    if (CSS.supports('view-timeline', '--card block') &&
        CSS.supports('view-timeline-inset', '10% 20%') &&
        CSS.supports('animation-timeline', '--card')) {
      const style = getComputedStyle(document.querySelector('.subject'));
      console.log('Named view timeline syntax: supported');
      console.log(`Computed name and axis: ${style.getPropertyValue('view-timeline-name')} ${style.getPropertyValue('view-timeline-axis')}`);
      console.log(`Computed inset: ${style.getPropertyValue('view-timeline-inset')}`);
      console.log(`Computed animation timeline: ${style.getPropertyValue('animation-timeline')}`);
    } else {
      console.log('Named view timeline syntax: unsupported');
    }
  </script>
</body>
</html>

Ergebnis

Named view timeline syntax: supported
Computed name and axis: --card block
Computed inset: 10% 20%
Computed animation timeline: --card

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen