ViewTimeline: ViewTimeline() Konstruktor
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Der ViewTimeline()
Konstruktor erstellt eine neue Instanz des ViewTimeline
-Objekts.
Syntax
new ViewTimeline(options)
Parameter
options
-
Ein Objekt, das die folgenden Eigenschaften enthalten kann:
subject
-
Eine Referenz zu einem
Element
, das das Subjektelement repräsentiert, dessen Sichtbarkeit innerhalb seines nächsten vorangehenden scrollbaren Elements (Scroller) den Fortschritt der Timeline steuern wird. axis
Optional-
Ein Wert aus einer Aufzählung, der die Scrollachse repräsentiert, die den Fortschritt der Timeline steuern wird. Mögliche Werte sind:
"block"
: Die Scrollbar auf der Blockachse des Scrollcontainers, die senkrecht zur Textflussrichtung in einer Zeile verläuft. Für horizontale Schreibrichtungen, wie standardmäßiges Englisch, entspricht dies"y"
, während es bei vertikalen Schreibrichtungen"x"
entspricht."inline"
: Die Scrollbar auf der Inline-Achse des Scrollcontainers, die parallel zur Textflussrichtung in einer Zeile verläuft. Für horizontale Schreibrichtungen entspricht dies"x"
, während es bei vertikalen Schreibrichtungen"y"
entspricht."y"
: Die Scrollbar auf der vertikalen Achse des Scrollcontainers."x"
: Die Scrollbar auf der horizontalen Achse des Scrollcontainers.
Falls weggelassen, ist
axis
standardmäßig"block"
. inset
Optional-
Ein Wert oder ein Array von Werten, die eine Anpassung der Position des Sichtbereichs (siehe Scrollcontainer für mehr Details) darstellen, in dem das Subjekt als sichtbar angesehen wird. Mögliche Werte sind:
"auto"
: Die Standardposition des Kastens wird verwendet.- Ein String: Wenn ein String angegeben ist, kann er aus einem oder zwei Werten bestehen, die
auto
oder ein CSS<length-percentage>
-Wert sind. Anders ausgedrückt, der String sollte ein gültigerview-timeline-inset
-Wert sein. - Ein Array von einem oder zwei Werten, die
"auto"
oder ein geeigneterCSSNumericValue
sein können, um einen Längen- oder Prozentversatz zu repräsentieren (zum BeispielCSS.px()
oderCSS.percent()
). Wenn ein Array bereitgestellt wird, repräsentiert der erste Wert den Start-Inset (der den WertViewTimeline.endOffset
beeinflusst), und der zweite Wert repräsentiert den End-Inset (der den WertViewTimeline.startOffset
beeinflusst).
Wenn das Array nur einen Wert enthält, wird dieser dupliziert.
Falls weggelassen, ist
inset
standardmäßigauto
.
Rückgabewert
Eine neue Instanz des ViewTimeline
-Objekts.
Beispiele
Sehen Sie sich die Hauptseite ViewTimeline
für ein Beispiel an.