Skip to content

Commit

Permalink
Editorial: make enumerated attributes missing/invalid wording consistent
Browse files Browse the repository at this point in the history 
See #9832 for context.
  • Loading branch information
@keithamus
keithamus authored Nov 23, 2023
1 parent 4c075c2 commit d24465d
Showing 1 changed file with 56 additions and 58 deletions.
114 changes: 56 additions & 58 deletions source
View file
Original file line number Diff line number Diff line change
Expand Up @@ -7354,11 +7354,12 @@ a.setAttribute('href', 'https://example.com/'); // change the content attribute
data-x="">include</code>".
</table>

<p>The attribute's <i data-x="invalid value default">invalid value default</i> is the <span
data-x="attr-crossorigin-anonymous">Anonymous</span> state, and its <i data-x="missing value
default">missing value default</i> is the <dfn data-x="attr-crossorigin-none">No CORS</dfn> state.
For the purposes of <span data-x="reflect">reflection</span>, the <span>canonical keyword</span>
for the <span data-x="attr-crossorigin-anonymous">Anonymous</span> state is the <code
<p>The attribute's <i data-x="missing value default">missing value default</i> is the <dfn
data-x="attr-crossorigin-none">No CORS</dfn> state, and its <i data-x="invalid value
default">invalid value default</i> is the <span
data-x="attr-crossorigin-anonymous">Anonymous</span> state. For the purposes of <span
data-x="reflect">reflection</span>, the <span>canonical keyword</span> for the <span
data-x="attr-crossorigin-anonymous">Anonymous</span> state is the <code
data-x="attr-crossorigin-anonymous-keyword">anonymous</code> keyword.</p>

<p>The majority of fetches governed by <span data-x="CORS settings attribute">CORS settings
Expand Down Expand Up @@ -7389,8 +7390,8 @@ a.setAttribute('href', 'https://example.com/'); // change the content attribute
<span>referrer policy</span>, including the empty string, is a keyword for this attribute, mapping
to a state of the same name.</p>

<p>The attribute's <i data-x="invalid value default">invalid value default</i> and <i
data-x="missing value default">missing value default</i> are both the empty string state.</p>
<p>The attribute's <i data-x="missing value default">missing value default</i> and <i
data-x="invalid value default">invalid value default</i> are both the empty string state.</p>

<p>The impact of these states on the processing model of various <span
data-x="concept-fetch">fetches</span> is defined in more detail throughout this specification, in
Expand Down Expand Up @@ -13413,7 +13414,7 @@ Transport Protocol">HTTP&lt;/abbr> today.&lt;/p></code></pre> <!-- DO NOT REWRAP
data-x="">no</code>. The empty string and the <code data-x="">yes</code> keyword map to the
<i>yes</i> state. The <code data-x="">no</code> keyword maps to the <i>no</i> state. In addition,
there is a third state, the <i>inherit</i> state, which is the <i
data-x="missing value default">missing value default</i> and the <i
data-x="missing value default">missing value default</i> and <i
data-x="invalid value default">invalid value default</i>.</p>

<p>Each element (even non-HTML elements) has a <dfn>translation mode</dfn>, which is in either the
Expand Down Expand Up @@ -13541,9 +13542,9 @@ Transport Protocol">HTTP&lt;/abbr> today.&lt;/p></code></pre> <!-- DO NOT REWRAP
per-paragraph level.</p>
</div>

<p>The <code data-x="attr-dir">dir</code> attribute's <i data-x="invalid value default">invalid
value default</i> and <i data-x="missing value default">missing value default</i> are both the
<dfn data-x="attr-dir-undefined-state">undefined</dfn> state.</p>
<p>The attribute's <i data-x="missing value default">missing value default</i> and <i
data-x="invalid value default">invalid value default</i> are both the <dfn
data-x="attr-dir-undefined-state">undefined</dfn> state.</p>

<hr>

Expand Down Expand Up @@ -35123,8 +35124,8 @@ interface <dfn interface>HTMLTrackElement</dfn> : <span>HTMLElement</span> {
<td><dfn data-x="attr-track-kind-metadata">Metadata</dfn>
</table>

<p>The <i data-x="missing value default">missing value default</i> is the <span
data-x="attr-track-kind-subtitles">subtitles</span> state. The <i data-x="invalid value
<p>The attribute's <i data-x="missing value default">missing value default</i> is the <span
data-x="attr-track-kind-subtitles">subtitles</span> state, and its <i data-x="invalid value
default">invalid value default</i> is the <span data-x="attr-track-kind-metadata">metadata</span>
state.</p>

Expand Down Expand Up @@ -43561,9 +43562,8 @@ interface <dfn interface>HTMLTableCellElement</dfn> : <span>HTMLElement</span> {
context.</dd>
</dl>

<p>The <code data-x="attr-th-scope">scope</code> attribute's <i data-x="missing value
default">missing value default</i> and <i data-x="invalid value default">invalid value default</i>
are the <i>auto</i> state.</p>
<p>The attribute's <i data-x="missing value default">missing value default</i> and <i
data-x="invalid value default">invalid value default</i> are both the <i>auto</i> state.</p>

<p>The <code>th</code> element may have an <dfn element-attr for="th"><code
data-x="attr-th-abbr">abbr</code></dfn> content attribute specified. Its value must be an
Expand Down Expand Up @@ -45506,8 +45506,8 @@ interface <dfn interface>HTMLFormElement</dfn> : <span>HTMLElement</span> {
data-x="attr-form-autocomplete-on-state">on</dfn> state, and the <dfn><code
data-x="attr-form-autocomplete-off">off</code></dfn> keyword maps to the <dfn
data-x="attr-form-autocomplete-off-state">off</dfn> state. The attribute may also be omitted. The
<i data-x="missing value default">missing value default</i> and the <i data-x="invalid value
default">invalid value default</i> are the <span
<i data-x="missing value default">missing value default</i> and <i data-x="invalid value
default">invalid value default</i> are both the <span
data-x="attr-form-autocomplete-on-state">on</span> state. The <span
data-x="attr-form-autocomplete-off-state">off</span> state indicates that by default, form
controls in the form will have their <span>autofill field name</span> set to "<code
Expand Down Expand Up @@ -46432,8 +46432,8 @@ interface <dfn interface>HTMLInputElement</dfn> : <span>HTMLElement</span> {
<td> A button
</table>

<p>The <i data-x="missing value default">missing value default</i> and the <i
data-x="invalid value default">invalid value default</i> are the <span
<p>The attribute's <i data-x="missing value default">missing value default</i> and <i
data-x="invalid value default">invalid value default</i> are both the <span
data-x="attr-input-type-text">Text</span> state.</p>

<p>Which of the
Expand Down Expand Up @@ -52769,8 +52769,8 @@ interface <dfn interface>HTMLButtonElement</dfn> : <span>HTMLElement</span> {
<td>Does nothing.
</table>

<p>The <i data-x="missing value default">missing value default</i> and <i
data-x="invalid value default">invalid value default</i> are the <span
<p>The attribute's <i data-x="missing value default">missing value default</i> and <i
data-x="invalid value default">invalid value default</i> are both the <span
data-x="attr-button-type-submit-state">Submit Button</span> state.</p>

<p>If the <code data-x="attr-button-type">type</code> attribute is in the <span
Expand Down Expand Up @@ -54212,7 +54212,7 @@ interface <dfn interface>HTMLTextAreaElement</dfn> : <span>HTMLElement</span> {
attr-value for="textarea/wrap"><code data-x="attr-textarea-wrap-hard">hard</code></dfn> keyword
which maps to the <span data-x="attr-textarea-wrap-hard-state">Hard</span> state. The <i
data-x="missing value default">missing value default</i> and <i data-x="invalid value
default">invalid value default</i> are the <span
default">invalid value default</i> are both the <span
data-x="attr-textarea-wrap-soft-state">Soft</span> state.</p>

<p>The <dfn data-x="attr-textarea-wrap-soft-state">Soft</dfn> state indicates that the text in the
Expand Down Expand Up @@ -56016,13 +56016,13 @@ form.method === input; // => true</code></pre>

</ul>

<p>The <code data-x="attr-fs-method">method</code> attribute's <i data-x="invalid value
default">invalid value default</i> and <i data-x="missing value default">missing value default</i>
are both the <span data-x="attr-fs-method-GET">GET</span> state.</p>
<p>The attribute's <i data-x="missing value default">missing value default</i> and <i
data-x="invalid value default">invalid value default</i> are both the <span
data-x="attr-fs-method-GET">GET</span> state.</p>

<p>The <code data-x="attr-fs-formmethod">formmethod</code> attribute's <i data-x="invalid value
default">invalid value default</i> is the <span data-x="attr-fs-method-GET">GET</span> state. It
has no <i data-x="missing value default">missing value default</i>.</p>
<p>The <code data-x="attr-fs-formmethod">formmethod</code> attribute has no <i data-x="missing
value default">missing value default</i>, and its <i data-x="invalid value default">invalid value
default</i> is the <span data-x="attr-fs-method-GET">GET</span> state.</p>

<p>The <dfn data-x="concept-fs-method">method</dfn> of an element is one of those states. If the
element is a <span data-x="concept-submit-button">submit button</span> and has a <code
Expand Down Expand Up @@ -56102,15 +56102,14 @@ form.method === input; // => true</code></pre>
data-x="attr-fs-enctype-text">text/plain</code></dfn>" keyword and corresponding state.</li>
</ul>

<p>The <code data-x="attr-fs-enctype">enctype</code> attribute's <i data-x="invalid value
default">invalid value default</i> and <i data-x="missing value default">missing value default</i>
are both the <code data-x="attr-fs-enctype-urlencoded">application/x-www-form-urlencoded</code>
state.</p>
<p>The attribute's <i data-x="missing value default">missing value default</i> and <i
data-x="invalid value default">invalid value default</i> are both the <code
data-x="attr-fs-enctype-urlencoded">application/x-www-form-urlencoded</code> state.</p>

<p>The <code data-x="attr-fs-formenctype">formenctype</code> attribute's <i data-x="invalid value
default">invalid value default</i> is the <code
data-x="attr-fs-enctype-urlencoded">application/x-www-form-urlencoded</code> state. It has no <i
data-x="missing value default">missing value default</i>.</p>
<p>The <code data-x="attr-fs-formenctype">formenctype</code> attribute has no <i data-x="missing
value default">missing value default</i>, and its <i data-x="invalid value default">invalid value
default</i> is the <code
data-x="attr-fs-enctype-urlencoded">application/x-www-form-urlencoded</code> state.</p>

<p>The <dfn data-x="concept-fs-enctype">enctype</dfn> of an element is one of those three states.
If the element is a <span data-x="concept-submit-button">submit button</span> and has a <code
Expand Down Expand Up @@ -77506,10 +77505,10 @@ END:VCARD</pre>
<td><dfn attr-value for="html-global/hidden"><code data-x="attr-hidden-hidden-keyword">hidden</code></dfn>
</table>

<p>The attribute may be omitted. The <i data-x="invalid value default">invalid value default</i>
is the <span data-x="attr-hidden-hidden-state">hidden state</span>. The <i data-x="missing value
default">missing value default</i> is the <dfn data-x="attr-hidden-not-hidden-state">not
hidden state</dfn>.</p>
<p>The attribute's <i data-x="missing value default">missing value default</i> is the <dfn
data-x="attr-hidden-not-hidden-state">not hidden state</dfn>, and its <i data-x="invalid value
default">invalid value default</i> is the <span data-x="attr-hidden-hidden-state">hidden
state</span>.</p>

<p>When an element has the <code data-x="attr-hidden">hidden</code> attribute in the <dfn
data-x="attr-hidden-hidden-state">hidden state</dfn>, it indicates that the element is not yet, or
Expand Down Expand Up @@ -80298,7 +80297,7 @@ addShortcutKeyLabel(document.getElementById('c'));</code></pre>
The <code data-x="">plaintext-only</code> keyword maps to the <i>plaintext-only</i> state.
The <code data-x="">false</code> keyword maps to the <i>false</i> state. In addition, there is a
fourth state, the <i>inherit</i> state, which is the <i data-x="missing value default">missing
value default</i> and the <i data-x="invalid value default">invalid value default</i>.</p>
value default</i> and <i data-x="invalid value default">invalid value default</i>.</p>

<p>The <i>true</i> state indicates that the element is editable. The <i>plaintext-only</i> state
indicates that only the element's raw text content is editable, but rich text formatting is
Expand Down Expand Up @@ -80560,7 +80559,7 @@ body { display:none }
data-x="">true</code> and <code data-x="">false</code>. The empty string and the <code
data-x="">true</code> keyword map to the <i>true</i> state. The <code data-x="">false</code>
keyword maps to the <i>false</i> state. In addition, there is a third state, the <i>default</i>
state, which is the <i data-x="missing value default">missing value default</i> and the <i
state, which is the <i data-x="missing value default">missing value default</i> and <i
data-x="invalid value default">invalid value default</i>.</p>

<p class="note">The <i>true</i> state indicates that the element is to have its spelling and
Expand Down Expand Up @@ -80824,10 +80823,10 @@ body { display:none }
<td><span data-x="autocap-hint-characters">characters</span>
</table>

<p>The <i data-x="invalid value default">invalid value default</i> is the <span
data-x="autocap-hint-sentences">sentences</span> state. The <i data-x="missing value
default">missing value default</i> is the <span data-x="autocap-hint-default">default</span>
state.</p>
<p>The attribute's <i data-x="missing value default">missing value default</i> is the <span
data-x="autocap-hint-default">default</span> state, and its <i data-x="invalid value
default">invalid value default</i> is the <span data-x="autocap-hint-sentences">sentences</span>
state.

<dl class="domintro">
<dt><code data-x=""><var>element</var>.<span subdfn data-x="dom-autocapitalize">autocapitalize</span> [ = <var>value</var> ]</code></dt>
Expand Down Expand Up @@ -83728,7 +83727,7 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
three states. The first state is <i>true</i> and it has the keyword <code data-x="">true</code>.
The second state is <i>false</i> and it has the keyword <code data-x="">false</code>. The third
state is <i>auto</i>; it has no keywords but it is the <i data-x="missing value default">missing
value default</i> and the <i data-x="invalid value default">invalid value default</i>.</p>
value default</i> and <i data-x="invalid value default">invalid value default</i>.</p>

<p>The <i>true</i> state means the element is draggable; the <i>false</i> state means that it is
not. The <i>auto</i> state uses the default behavior of the user agent.</p>
Expand Down Expand Up @@ -83943,10 +83942,10 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
</tbody>
</table>

<p>The <code data-x="attr-popover">popover</code> attribute's <i data-x="invalid value
<p>The attribute's <i data-x="missing value default">missing value default</i> is the <dfn
data-x="attr-popover-none-state">no popover</dfn> state, and its <i data-x="invalid value
default">invalid value default</i> is the <span data-x="attr-popover-manual-state">manual</span>
state and its <i data-x="missing value default">missing value default</i> is the <dfn
data-x="attr-popover-none-state">no popover</dfn> state.</p>
state.</p>

<p>The <dfn attribute for="HTMLElement"><code data-x="dom-popover">popover</code></dfn> IDL
attribute must <span>reflect</span> the <span data-x="attr-popover">popover</span> attribute,
Expand Down Expand Up @@ -84710,9 +84709,8 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
<td>Hides the targeted popover element.
</table>

<p>The <code data-x="attr-popovertargetaction">popovertargetaction</code> attribute's <i
data-x="invalid value default">invalid value default</i> and <i data-x="missing value
default">missing value default</i> are both the <span
<p>The attribute's <i data-x="missing value default">missing value default</i> and <i
data-x="invalid value default">invalid value default</i> are both the <span
data-x="attr-popovertargetaction-toggle-state">toggle</span> state.</p>

<p class="note">Whenever possible ensure the popover element is placed immediately after its
Expand Down Expand Up @@ -133590,8 +133588,8 @@ interface <dfn interface>HTMLMarqueeElement</dfn> : <span>HTMLElement</span> {
<td><dfn data-x="attr-marquee-behavior-alternate">alternate</dfn>
</table>

<p>The <i data-x="missing value default">missing value default</i> and <i
data-x="invalid value default">invalid value default</i> are the <span
<p>The attribute's <i data-x="missing value default">missing value default</i> and <i
data-x="invalid value default">invalid value default</i> are both the <span
data-x="attr-marquee-behavior-scroll">scroll</span> state.</p>

<hr>
Expand Down Expand Up @@ -133621,8 +133619,8 @@ interface <dfn interface>HTMLMarqueeElement</dfn> : <span>HTMLElement</span> {
<td><dfn data-x="attr-marquee-direction-down">down</dfn>
</table>

<p>The <i data-x="missing value default">missing value default</i> and <i
data-x="invalid value default">invalid value default</i> are the <span
<p>The attribute's <i data-x="missing value default">missing value default</i> and <i
data-x="invalid value default">invalid value default</i> are both the <span
data-x="attr-marquee-direction-left">left</span> state.</p>

<hr>
Expand Down

0 comments on commit d24465d

Please sign in to comment.