Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Re-add the inert="" attribute #1474

Closed
wants to merge 1 commit into from
Closed

Re-add the inert="" attribute #1474

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 24 additions & 4 deletions source
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9598,6 +9598,7 @@ interface <dfn>HTMLElement</dfn> : <span>Element</span> {

// <span>user interaction</span>
[<span>CEReactions</span>] attribute boolean <span data-x="dom-hidden">hidden</span>;
[<span>CEReactions</span>] attribute boolean <span data-x="dom-inert">inert</span>;
void <span data-x="dom-click">click</span>();
[<span>CEReactions</span>] attribute long <span data-x="dom-tabindex">tabIndex</span>;
void <span data-x="dom-focus">focus</span>();
Expand Down Expand Up @@ -10724,6 +10725,7 @@ http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20HTML%3E%0
<li><code data-x="attr-draggable">draggable</code></li>
<li><code data-x="attr-dropzone">dropzone</code></li>
<li><code data-x="attr-hidden">hidden</code></li>
<li><code data-x="attr-inert">inert</code></li>
<li><code data-x="attr-is">is</code></li>
<li><code data-x="attr-itemid">itemid</code></li>
<li><code data-x="attr-itemprop">itemprop</code></li>
Expand Down Expand Up @@ -72236,10 +72238,6 @@ END:VCARD</pre>

<h3>Inert subtrees</h3>

<p class="note">This section <strong>does not</strong> define or create any content attribute
named "inert". This section merely defines an abstract <em>concept</em> of
<span data-x="inert">inertness</span>.</p>

<p>A node (in particular elements and text nodes) can be marked as <dfn>inert</dfn>. When a node
is <span>inert</span>, then the user agent must act as if the node was absent for the purposes of
targeting user interaction events, may ignore the node for the purposes of text search user
Expand Down Expand Up @@ -72275,8 +72273,25 @@ END:VCARD</pre>
<p class="note">The <code>dialog</code> element's <code
data-x="dom-dialog-showModal">showModal()</code> method makes use of this mechanism.</p>

<h4>The <dfn data-x="attr-inert"><code>inert</code></dfn> attribute</h4>

<p>The <code data-x="attr-inert">inert</code> attribute is a <span>boolean attribute</span> that
indicates, by its presence, that the element and all its descendants is to be made
<span>inert</span>.</p>

<p w-nodev>When an element has an <code data-x="attr-inert">inert</code> attribute, the user agent
must mark that element and all its descendants as <span>inert</span>.</p>

<p class="note">By default, there is no visual indication of a subtree being inert. Authors are
encouraged to clearly mark what parts of their document are active and which are inert, to avoid
user confusion. In particular, it is worth remembering that not all users can see all parts of a
page at once; for example, users of screen readers, users on small devices or with magnifiers, and
even users just using particularly small windows might not be able to see the active part of a
page and may get frustrated if inert sections are not obviously inert. For individual controls,
the <code data-x="attr-fe-disabled">disabled</code> attribute is probably more appropriate.</p>

<p>The <dfn data-x="dom-inert"><code>inert</code></dfn> IDL attribute must <span>reflect</span>
the content attribute of the same name.</p>

<h3>Activation</h3>

Expand Down Expand Up @@ -116531,6 +116546,11 @@ interface <dfn>External</dfn> {
<td> <span data-x="attr-id">HTML elements</span>
<td> The element's <span data-x="concept-id">ID</span>
<td> <a href="#attribute-text">Text</a>*
<tr>
<th> <code data-x="">inert</code>
<td> <span data-x="attr-inert">HTML elements</span>
<td> Whether the element and its descendants are <span>inert</span>
<td> <span>Boolean attribute</span>
<tr>
<th> <code data-x="">inputmode</code>
<td> <code data-x="attr-fe-inputmode">input</code>;
Expand Down