diff --git a/Overview.bs b/Overview.bs index 9b1e8a78cac..76f70bad092 100644 --- a/Overview.bs +++ b/Overview.bs @@ -370,6 +370,14 @@ not by wall-clock time, but by the progress of scrolling in a [=scroll container
+
+ +: ScrollTimeline(options) +:: Creates a new {{ScrollTimeline}} object. The attributes of the {{ScrollTimeline}} are + initialized with the respective members of the {{options}} dictionary. + +
+
: scrollSource diff --git a/index.html b/index.html index 8f0cd1a1c8f..822a30aef6b 100644 --- a/index.html +++ b/index.html @@ -572,7 +572,7 @@

FillMode fill = "none"; }; -[Constructor(optional ScrollTimelineOptions options)] +[Constructor(optional ScrollTimelineOptions options)] interface ScrollTimeline : AnimationTimeline { readonly attribute Element scrollSource; readonly attribute ScrollDirection orientation; @@ -585,6 +585,15 @@

A scroll timeline is an AnimationTimeline whose time values are determined not by wall-clock time, but by the progress of scrolling in a scroll container.

+
+
+
+

ScrollTimeline(options)

+
+

Creates a new ScrollTimeline object. The attributes of the ScrollTimeline are +initialized with the respective members of the options dictionary.

+
+
scrollSource, of type Element, readonly @@ -592,7 +601,7 @@

The scrollable element whose scrolling triggers the activation and drives the progress of the timeline.

If this is not specified, the document element of the active document for the -current browsing context, as determined at the time the ScrollTimeline is +current browsing context, as determined at the time the ScrollTimeline is constructed, is used.

Note that the scrollSource's ownerDocument may change over the lifetime of the scroll timeline. This does not affect the scroll timeline; the timeline @@ -683,8 +692,8 @@

-

3.1.3. The effective time range of a ScrollTimeline

-

The effective time range of a ScrollTimeline is calculated as follows:

+

3.1.3. The effective time range of a ScrollTimeline

+

The effective time range of a ScrollTimeline is calculated as follows:

If the timeRange has the value "auto", @@ -695,11 +704,11 @@

Otherwise,
-

The effective time range is the ScrollTimeline's timeRange.

+

The effective time range is the ScrollTimeline's timeRange.

-

3.1.4. The current time of a ScrollTimeline

-

The current time of a ScrollTimeline is calculated +

3.1.4. The current time of a ScrollTimeline

+

The current time of a ScrollTimeline is calculated as follows:

  1. @@ -720,7 +729,7 @@

3.2. The animation-timeline property

-

A ScrollTimeline may be applied to a CSS Animation [CSS3-ANIMATIONS] using +

A ScrollTimeline may be applied to a CSS Animation [CSS3-ANIMATIONS] using the animation-timeline property.

@@ -770,7 +779,7 @@

The animation’s timeline is a DocumentTimeline, more specifically the default document timeline.

scroll([element(<id-selector>)[, <scroll-direction>[, <scroll-offset>[, <scroll-offset>[, <time>[, <single-animation-fill-mode>]]]]]])
-

The animation’s timeline is a ScrollTimeline.

+

The animation’s timeline is a ScrollTimeline.

The timeline’s scrollSource is the scroll container identified by the <id-selector>, defaulting to the element’s nearest scrollable ancestor.

The <scroll-direction>, if provided, determines the timeline’s orientation.

@@ -842,7 +851,7 @@

layout cycles, where a change to a scroll offset causes an animation’s effect to update, which in turn causes a new change to the scroll offset.

-

To avoid such cycles, animations with a ScrollTimeline are sampled once +

To avoid such cycles, animations with a ScrollTimeline are sampled once per frame, after scrolling in response to input events has taken place, but before requestAnimationFrame() callbacks are run. If the sampling of such an animation causes a change to a scroll offset, the animation will not be @@ -1030,7 +1039,6 @@

scroll timeline, in §3.1.2
  • ScrollTimeline, in §3.1.2 -
  • ScrollTimeline(), in §3.1.2
  • ScrollTimelineAutoKeyword, in §3.1.2
  • ScrollTimeline(options), in §3.1.2
  • ScrollTimelineOptions, in §3.1.2 @@ -1211,7 +1219,7 @@

    I FillMode fill = "none"; }; -[Constructor(optional ScrollTimelineOptions options)] +[Constructor(optional ScrollTimelineOptions options)] interface ScrollTimeline : AnimationTimeline { readonly attribute Element scrollSource; readonly attribute ScrollDirection orientation; @@ -1254,14 +1262,20 @@

    3.1.2. The ScrollTimeline interface + +