Skip to content

Commit b585e64

Browse files
committed
[css-view-transitions-1][editorial] More consolidation
* Move conceptual data held on ViewTransition next to the rest of the conceptual data * Pull “Monkey Patches” section up since it's part of the module's interface with the rest of the world
1 parent 6afcbc9 commit b585e64

File tree

1 file changed

+46
-39
lines changed

1 file changed

+46
-39
lines changed

css-view-transitions-1/Overview.bs

Lines changed: 46 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -977,6 +977,50 @@ urlPrefix: https://wicg.github.io/navigation-api/; type: interface;
977977
If {{ViewTransition/finished}} hasn't resolved, it will fulfill or reject along with {{ViewTransition/updateCallbackDone}}.
978978
</dl>
979979

980+
The {{ViewTransition/finished}} [=getter steps=] are to return [=this's=] [=ViewTransition/finished promise=].
981+
982+
The {{ViewTransition/ready}} [=getter steps=] are to return [=this's=] [=ViewTransition/ready promise=].
983+
984+
The {{ViewTransition/updateCallbackDone}} [=getter steps=] are to return [=this's=] [=ViewTransition/update callback done promise=].
985+
986+
### {{ViewTransition/skipTransition()}} Method Steps ### {#ViewTransition-skipTransition}
987+
988+
<div algorithm>
989+
The [=method steps=] for <dfn method for="ViewTransition">skipTransition()</dfn> are:
990+
991+
1. If [=this=]'s [=ViewTransition/phase=] is not "`done`",
992+
then [=skip the view transition=] for [=this=]
993+
with an "{{AbortError}}" {{DOMException}}.
994+
</div>
995+
996+
## Integration into Other APIs ## {#monkey-patch-to-rendering-algorithm}
997+
998+
<div algorithm="monkey patch to rendering">
999+
Run the following steps before <a href="https://html.spec.whatwg.org/multipage/webappapis.html#event-loop-processing-model:run-the-update-intersection-observations-steps">intersection observer steps</a> in the [=update the rendering=] steps:
1000+
1001+
1. For each [=fully active=] {{Document}} in <var ignore>docs</var>,
1002+
[=perform pending transition operations=] for that {{Document}}.
1003+
1004+
Note: These steps will be added to the [=update the rendering=] in the HTML spec.
1005+
As such, the prose style is written to match other steps in that algorithm.
1006+
</div>
1007+
1008+
<div algorithm="suppress rendering">
1009+
In the definition for [=rendering opportunity=], add the following condition:
1010+
1011+
A navigable has no rendering opportunities if active document has [=document/transition suppressing rendering=] set to true.
1012+
1013+
Note: These steps will be added to the [=update the rendering=] in the HTML spec.
1014+
See <a href="https://github.com/w3c/csswg-drafts/issues/7784">#7884</a> for more context.
1015+
</div>
1016+
1017+
1018+
# Algorithms # {#algorithms}
1019+
1020+
## Data Structures ## {#concepts}
1021+
1022+
### Data on {{ViewTransition}} ### {#additions-to-viewtransition}
1023+
9801024
A {{ViewTransition}} has the following:
9811025

9821026
<dl dfn-for="ViewTransition">
@@ -1032,27 +1076,11 @@ urlPrefix: https://wicg.github.io/navigation-api/; type: interface;
10321076
[Discussion of this behavior](https://github.com/w3c/csswg-drafts/issues/8045).
10331077
</dl>
10341078

1035-
The {{ViewTransition/finished}} [=getter steps=] are to return [=this's=] [=ViewTransition/finished promise=].
1036-
1037-
The {{ViewTransition/ready}} [=getter steps=] are to return [=this's=] [=ViewTransition/ready promise=].
1038-
1039-
The {{ViewTransition/updateCallbackDone}} [=getter steps=] are to return [=this's=] [=ViewTransition/update callback done promise=].
1040-
1041-
### {{ViewTransition/skipTransition()}} ### {#ViewTransition-skipTransition}
1042-
1043-
<div algorithm>
1044-
The [=method steps=] for <dfn method for="ViewTransition">skipTransition()</dfn> are:
1045-
1046-
1. If [=this=]'s [=ViewTransition/phase=] is not "`done`",
1047-
then [=skip the view transition=] for [=this=]
1048-
with an "{{AbortError}}" {{DOMException}}.
1049-
</div>
1050-
10511079
# Algorithms # {#algorithms}
10521080

10531081
## Data Structures ## {#concepts}
10541082

1055-
### Additions to {{Document}} ### {#additions-to-document}
1083+
### Data on {{Document}} ### {#additions-to-document}
10561084

10571085
A {{Document}} additionally has:
10581086

@@ -1084,7 +1112,7 @@ urlPrefix: https://wicg.github.io/navigation-api/; type: interface;
10841112
Note: The position of the [=ViewTransition/transition root pseudo-element=] within the [=document element=] does not matter, as the [=ViewTransition/transition root pseudo-element=]'s [=containing block=] is the [=snapshot containing block=].
10851113
</dl>
10861114

1087-
### Additions to Elements ### {#elements-concept}
1115+
### Data on Elements ### {#elements-concept}
10881116

10891117
[=/Elements=] have a <dfn export>captured in a view transition</dfn> boolean, initially false.
10901118

@@ -1137,27 +1165,6 @@ urlPrefix: https://wicg.github.io/navigation-api/; type: interface;
11371165
Note: These are used to update, and later remove styles
11381166
from a [=/document=]'s [=document/dynamic view transition style sheet=].
11391167

1140-
## Monkey patches to rendering ## {#monkey-patch-to-rendering-algorithm}
1141-
1142-
<div algorithm="monkey patch to rendering">
1143-
Run the following steps before <a href="https://html.spec.whatwg.org/multipage/webappapis.html#event-loop-processing-model:run-the-update-intersection-observations-steps">intersection observer steps</a> in the [=update the rendering=] steps:
1144-
1145-
1. For each [=fully active=] {{Document}} in <var ignore>docs</var>,
1146-
[=perform pending transition operations=] for that {{Document}}.
1147-
1148-
Note: These steps will be added to the [=update the rendering=] in the HTML spec.
1149-
As such, the prose style is written to match other steps in that algorithm.
1150-
</div>
1151-
1152-
<div algorithm="suppress rendering">
1153-
In the definition for [=rendering opportunity=], add the following condition:
1154-
1155-
A navigable has no rendering opportunities if active document has [=document/transition suppressing rendering=] set to true.
1156-
1157-
Note: These steps will be added to the [=update the rendering=] in the HTML spec.
1158-
See <a href="https://github.com/w3c/csswg-drafts/issues/7784">#7884</a> for more context.
1159-
</div>
1160-
11611168
## [=Perform pending transition operations=] ## {#perform-pending-transition-operations-algorithm}
11621169

11631170
<div algorithm>

0 commit comments

Comments
 (0)