Skip to content

Commit 3811489

Browse files
authored
Clarify that modal dialogs escape inertness of ancestors
Closes #7808.
1 parent 448f240 commit 3811489

File tree

1 file changed

+9
-5
lines changed

1 file changed

+9
-5
lines changed

source

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -75959,9 +75959,12 @@ END:VCARD</pre>
7595975959
<var>document</var>'s <span>top layer</span>. While <var>document</var> is so blocked, every node
7596075960
that is <span>connected</span> to <var>document</var>, with the exception of the
7596175961
<var>subject</var> element and its <span>flat tree</span> descendants, must become
75962-
<span>inert</span>. (The elements excepted by this paragraph can additionally become
75963-
<span>inert</span> through other means; being part of a modal dialog does not "protect" a node
75964-
from being <span>inert</span>.)</p>
75962+
<span>inert</span>.</p>
75963+
75964+
<p><var>subject</var> can additionally become <span>inert</span> via the <code
75965+
data-x="attr-inert">inert</code> attribute, but only if specified on <var>subject</var> itself
75966+
(i.e., <var>subject</var> escapes inertness of ancestors); <var>subject</var>'s <span>flat
75967+
tree</span> descendants can become <span>inert</span> in a similar fashion.</p>
7596575968

7596675969
<p class="note">The <code>dialog</code> element's <code
7596775970
data-x="dom-dialog-showModal">showModal()</code> method causes this mechanism to trigger, by
@@ -75971,8 +75974,9 @@ END:VCARD</pre>
7597175974
<h4>The <dfn data-x="attr-inert"><code>inert</code></dfn> attribute</h4>
7597275975

7597375976
<p>The <code data-x="attr-inert">inert</code> attribute is a <span>boolean attribute</span> that
75974-
indicates, by its presence, that the element and all its <span>flat tree</span> descendants are
75975-
to be made <span>inert</span> by the user agent.</p>
75977+
indicates, by its presence, that the element and all its <span>flat tree</span> descendants which
75978+
don't otherwise escape inertness (such as modal dialogs) are to be made <span>inert</span> by the
75979+
user agent.</p>
7597675980

7597775981
<p class="note">By default, there is no persistent visual indication of a subtree being inert.
7597875982
Authors are encouraged to clearly mark what parts of their document are active and which are

0 commit comments

Comments
 (0)