Skip to content

Commit b44d8c0

Browse files
authored
[css-view-transitions-1] Rename domUpdated to updateCallbackDone (w3c#8330)
1 parent 8706306 commit b44d8c0

1 file changed

Lines changed: 23 additions & 23 deletions

File tree

css-view-transitions-1/Overview.bs

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -502,10 +502,10 @@ urlPrefix: https://html.spec.whatwg.org/multipage/rendering.html; type: dfn;
502502

503503
<xmp class=idl>
504504
partial interface Document {
505-
ViewTransition startViewTransition(optional UpdateDOMCallback? callback = null);
505+
ViewTransition startViewTransition(optional UpdateCallback? callback = null);
506506
};
507507

508-
callback UpdateDOMCallback = Promise<any> ();
508+
callback UpdateCallback = Promise<any> ();
509509
</xmp>
510510

511511
### {{Document/startViewTransition()}} ### {#ViewTransition-prepare}
@@ -515,15 +515,15 @@ urlPrefix: https://html.spec.whatwg.org/multipage/rendering.html; type: dfn;
515515

516516
1. Let |transition| be a new {{ViewTransition}} object in [=this's=] [=relevant Realm=].
517517

518-
1. Set |transition|'s [=ViewTransition/DOM update callback=] to |callback|.
518+
1. Set |transition|'s [=ViewTransition/update callback=] to |callback|.
519519

520520
1. Let |document| be [=this's=] [=relevant global object's=] [=associated document=].
521521

522522
1. If |document|'s [=active DOM transition=] is not null,
523523
then [=skip the view transition=] |document|'s [=active DOM transition=]
524524
with an "{{AbortError}}" {{DOMException}} in [=this's=] [=relevant Realm=].
525525

526-
Note: This can result in two asynchronous [=ViewTransition/DOM update callbacks=] running concurrently.
526+
Note: This can result in two asynchronous [=ViewTransition/update callbacks=] running concurrently.
527527
One for the |document|'s current [=active DOM transition=], and another for this |transition|.
528528
As per the [design of this feature](#transitions-as-enhancements), it's assumed that the developer is using another feature or framework to correctly schedule these DOM changes.
529529

@@ -596,7 +596,7 @@ urlPrefix: https://html.spec.whatwg.org/multipage/rendering.html; type: dfn;
596596
undefined skipTransition();
597597
readonly attribute Promise<undefined> finished;
598598
readonly attribute Promise<undefined> ready;
599-
readonly attribute Promise<undefined> domUpdated;
599+
readonly attribute Promise<undefined> updateCallbackDone;
600600
};
601601
</xmp>
602602

@@ -615,22 +615,22 @@ urlPrefix: https://html.spec.whatwg.org/multipage/rendering.html; type: dfn;
615615
:: One of the following [=phases=]:
616616

617617
1. "`pending-capture`".
618-
1. "`dom-update-callback-called`".
618+
1. "`update-callback-called`".
619619
1. "`animating`".
620620
1. "`done`".
621621

622622
Note: For the most part, a developer using this API does not need to worry about the different phases, since they progress automatically.
623623
It is, however, important to understand what steps happen in each of the phases: when the snapshots are captured, when pseudo-element DOM is created, etc.
624624
The description of the phases below tries to be as precise as possible, with an intent to provide an unambiguous set of steps for implementors to follow in order to produce a spec-compliant implementation.
625625

626-
: <dfn>DOM update callback</dfn>
627-
:: an {{UpdateDOMCallback}} or null. Initially null.
626+
: <dfn>update callback</dfn>
627+
:: an {{UpdateCallback}} or null. Initially null.
628628

629629
: <dfn>ready promise</dfn>
630630
:: a {{Promise}}.
631631
Initially [=a new promise=] in [=this's=] [=relevant Realm=].
632632

633-
: <dfn>DOM updated promise</dfn>
633+
: <dfn>update callback done promise</dfn>
634634
:: a {{Promise}}.
635635
Initially [=a new promise=] in [=this's=] [=relevant Realm=].
636636

@@ -655,7 +655,7 @@ urlPrefix: https://html.spec.whatwg.org/multipage/rendering.html; type: dfn;
655655

656656
The {{ViewTransition/ready}} [=getter steps=] are to return [=this's=] [=ViewTransition/ready promise=].
657657

658-
The {{ViewTransition/domUpdated}} [=getter steps=] are to return [=this's=] [=ViewTransition/DOM updated promise=].
658+
The {{ViewTransition/updateCallbackDone}} [=getter steps=] are to return [=this's=] [=ViewTransition/update callback done promise=].
659659

660660
### {{ViewTransition/skipTransition()}} ### {#ViewTransition-skipTransition}
661661

@@ -793,9 +793,9 @@ urlPrefix: https://html.spec.whatwg.org/multipage/rendering.html; type: dfn;
793793

794794
Note: This happens if |transition| was [=skip the view transition|skipped=] before this point.
795795

796-
1. [=Call the DOM update callback=] of |transition|.
796+
1. [=Call the update callback=] of |transition|.
797797

798-
1. [=promise/React=] to |transition|'s [=ViewTransition/DOM updated promise=]:
798+
1. [=promise/React=] to |transition|'s [=ViewTransition/update callback done promise=]:
799799

800800
* If the promise does not settle within an implementation-defined timeout, then:
801801

@@ -885,7 +885,7 @@ urlPrefix: https://html.spec.whatwg.org/multipage/rendering.html; type: dfn;
885885

886886
1. [=Assert=]: |transition|'s [=ViewTransition/phase=] is not "`done`".
887887

888-
1. If |transition|'s [=ViewTransition/phase=] is [=phases/before=] "`dom-update-callback-called`", then [=call the DOM update callback=] of |transition|.
888+
1. If |transition|'s [=ViewTransition/phase=] is [=phases/before=] "`update-callback-called`", then [=call the update callback=] of |transition|.
889889

890890
1. Set [=document/transition suppressing rendering=] to false.
891891

@@ -897,12 +897,12 @@ urlPrefix: https://html.spec.whatwg.org/multipage/rendering.html; type: dfn;
897897

898898
Note: The ready promise would've been resolved if {{ViewTransition/skipTransition()}} is called after we start animating.
899899

900-
1. [=promise/React=] to |transition|'s [=ViewTransition/DOM updated promise=]:
900+
1. [=promise/React=] to |transition|'s [=ViewTransition/update callback done promise=]:
901901

902-
* If |transition|'s [=ViewTransition/DOM updated promise=] was resolved,
902+
* If |transition|'s [=ViewTransition/update callback done promise=] was resolved,
903903
then [=resolve=] |transition|'s [=ViewTransition/finished promise=].
904904

905-
* If |transition|'s [=ViewTransition/DOM updated promise=] was rejected with reason |reason|,
905+
* If |transition|'s [=ViewTransition/update callback done promise=] was rejected with reason |reason|,
906906
then [=reject=] |transition|'s [=ViewTransition/finished promise=] with |reason|.
907907
</div>
908908

@@ -1257,23 +1257,23 @@ urlPrefix: https://html.spec.whatwg.org/multipage/rendering.html; type: dfn;
12571257
</div>
12581258

12591259
<div algorithm>
1260-
To <dfn>call the DOM update callback</dfn> of a {{ViewTransition}} |transition|:
1260+
To <dfn>call the update callback</dfn> of a {{ViewTransition}} |transition|:
12611261

1262-
1. [=Assert=]: |transition|'s [=ViewTransition/phase=] is [=phases/before=] "`dom-update-callback-called`".
1262+
1. [=Assert=]: |transition|'s [=ViewTransition/phase=] is [=phases/before=] "`update-callback-called`".
12631263

12641264
1. Let |callbackPromise| be [=a new promise=] in |transition|'s [=relevant Realm=].
12651265

1266-
* If |transition|'s [=ViewTransition/DOM update callback=] is null, then resolve |callbackPromise|.
1266+
* If |transition|'s [=ViewTransition/update callback=] is null, then resolve |callbackPromise|.
12671267

1268-
* Otherwise, let |callbackPromise| be the result of [=/invoking=] |transition|'s [=ViewTransition/DOM update callback=].
1268+
* Otherwise, let |callbackPromise| be the result of [=/invoking=] |transition|'s [=ViewTransition/update callback=].
12691269

1270-
1. Set |transition|'s [=ViewTransition/phase=] to "`dom-update-callback-called`".
1270+
1. Set |transition|'s [=ViewTransition/phase=] to "`update-callback-called`".
12711271

12721272
1. [=promise/React=] to |callbackPromise|:
12731273

1274-
* If |callbackPromise| was resolved, then [=resolve=] |transition|'s [=ViewTransition/DOM updated promise=].
1274+
* If |callbackPromise| was resolved, then [=resolve=] |transition|'s [=ViewTransition/update callback done promise=].
12751275

1276-
* If |callbackPromise| was rejected with reason |r|, then [=reject=] |transition|'s [=ViewTransition/DOM updated promise=] with |r|.
1276+
* If |callbackPromise| was rejected with reason |r|, then [=reject=] |transition|'s [=ViewTransition/update callback done promise=] with |r|.
12771277
</div>
12781278

12791279
## [=Clear view transition=] ## {#clear-view-transition-algorithm}

0 commit comments

Comments
 (0)