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.