Skip to content

Commit 84e3e78

Browse files
committed
Updated note to be normative
1 parent 2fcac20 commit 84e3e78

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

css-contain-2/Overview.bs

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1590,13 +1590,13 @@ the rendering state changes and the element either becomes or stops being
15901590

15911591
This event is dispatched by posting a task at the time when the state change occurs.
15921592

1593-
<p class=note>This event is a convenient way to track the state of
1594-
''content-visibility: auto'' elements. By observing the event, the developer
1595-
can to stop or start additional work within the affected subtree, such as DOM
1596-
updates or canvas redraws. It is important to remember that
1597-
''content-visibility: auto'' subtree elements are exposed to accessibility
1598-
tooling. One must take care to ensure that the content remains sufficiently
1599-
updated for assistive technology consumption.</p>
1593+
Note that elements in ''content-visibility: auto'' subtrees remain semantically
1594+
relevant even for elements that [=skip its contents=]. This means that it is
1595+
inappropriate to use this signal to indefinitely skip DOM updates in the
1596+
subtree that is skipped. Instead, it should be used to deprioritize updates,
1597+
but ensure that the content remains semantically relevant and reasonably
1598+
up-to-date. This is particularly important for assistive technologies which
1599+
consume this content even when the ancestor is set to [=skip its contents=].
16001600

16011601
Restrictions and Clarifications {#cv-notes}
16021602
-------------------------------------------

0 commit comments

Comments
 (0)