Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

view-timeline — skrót nazwanej osi postępu widoczności

Właściwość view-timeline deklaruje na elemencie nazwaną oś postępu zależną od jego położenia w przewijanym obszarze. Łączy nazwę, kierunek i odsunięcia; animację podłącza się osobno przez animation-timeline.

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

Składnia

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

view-timeline jest skrótem właściwości view-timeline-name, view-timeline-axis i view-timeline-inset. Deklaruje oś na obserwowanym elemencie, ale sama nie uruchamia animacji. Postęp zależy od przechodzenia elementu przez obszar widoczności najbliższego przewijającego przodka, a nie od upływu czasu.

Nazwa ma postać identyfikatora rozpoczynającego się od --; none nie deklaruje nazwanej osi. Domyślne wartości składowych to none, block i auto. Skrót resetuje pominięte składowe. block i inline oznaczają osie logiczne, a x i y — fizyczne. Przecinki rozdzielają wiele osi; # w gramatyce oznacza taką listę.

Opcjonalne odsunięcia przyjmują jedną lub dwie wartości auto albo długości/procenty. Jedna wartość dotyczy obu końców; dwie określają początek i koniec. Dodatnie wartości zwężają zakres widoczności, ujemne go rozszerzają; procenty odnoszą się do wymiaru obszaru przewijania, a auto korzysta z scroll-padding.

W przykładzie animation-timeline: --card podłącza animację do zadeklarowanej osi. Umieść tę deklarację po animation, które resetuje wybór osi. Domyślny pełny zakres obejmuje przejście od pierwszego wejścia do całkowitego wyjścia. Przykład uruchomiono w odizolowanym środowisku z Chromium 157.0.8103.51, a komunikaty w konsoli dokładnie zgadzały się z oczekiwanym wynikiem. Same deklaracje CSS nie gwarantują obsługi przez przeglądarkę, więc sprawdź przykład również lokalnie.

Przykłady

<!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>

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła