Skip to content

Commit

Permalink
Editorial: add enumerated attribute table for draggable
Browse files Browse the repository at this point in the history
Helps with #9832.
  • Loading branch information
keithamus authored Dec 8, 2023
1 parent b2c8405 commit 17402ca
Showing 1 changed file with 35 additions and 16 deletions.
51 changes: 35 additions & 16 deletions source
Original file line number Diff line number Diff line change
Expand Up @@ -83797,14 +83797,32 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {

<p>All <span>HTML elements</span> may have the <dfn element-attr for="html-global"><code
data-x="attr-draggable">draggable</code></dfn> content attribute set. The <code
data-x="attr-draggable">draggable</code> attribute is an <span>enumerated attribute</span>. It has
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 <i data-x="invalid value default">invalid value default</i>.</p>
data-x="attr-draggable">draggable</code> attribute is an <span>enumerated attribute</span> with
the following keywords and states:</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>
<table>
<thead>
<tr>
<th>Keyword
<th>State
<th>Brief description
<tbody>
<tr>
<td><dfn attr-value for="html-global/draggable"><code
data-x="attr-draggable-true">true</code></dfn>
<td><dfn data-x="attr-draggable-true-state">true</dfn>
<td>The element will be draggable.
<tr>
<td><dfn attr-value for="html-global/draggable"><code
data-x="attr-draggable-false">false</code></dfn>
<td><dfn data-x="attr-draggable-false-state">false</dfn>
<td>The element will not be draggable.
</table>

<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-draggable-auto-state">auto</dfn> state. The auto state uses the default behavior of
the user agent.</p>

<p>An element with a <code data-x="attr-draggable">draggable</code> attribute should also have a
<code data-x="attr-title">title</code> attribute that names the element for the purpose of
Expand Down Expand Up @@ -83833,18 +83851,19 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
draggable as well.</p>

<p>If an element's <code data-x="attr-draggable">draggable</code> content attribute has the state
<i>true</i>, the <code data-x="dom-draggable">draggable</code> IDL attribute must return true.</p>
<span data-x="attr-draggable-true-state">true</span>, the <code
data-x="dom-draggable">draggable</code> IDL attribute must return true.</p>

<p>Otherwise, if the element's <code data-x="attr-draggable">draggable</code> content attribute has
the state <i>false</i>, the <code data-x="dom-draggable">draggable</code> IDL attribute must return
false.</p>
<p>Otherwise, if the element's <code data-x="attr-draggable">draggable</code> content attribute
has the state <span data-x="attr-draggable-false-state">false</span>, the <code
data-x="dom-draggable">draggable</code> IDL attribute must return false.</p>

<p>Otherwise, the element's <code data-x="attr-draggable">draggable</code> content attribute has
the state <i>auto</i>. If the element is an <code>img</code> element, an <code>object</code>
element that <span>represents</span> an image, or an <code>a</code> element with an <code
data-x="attr-hyperlink-href">href</code> content attribute, the <code
data-x="dom-draggable">draggable</code> IDL attribute must return true; otherwise, the <code
data-x="dom-draggable">draggable</code> IDL attribute must return false.</p>
the state <span data-x="attr-draggable-auto-state">auto</span>. If the element is an
<code>img</code> element, an <code>object</code> element that <span>represents</span> an image, or
an <code>a</code> element with an <code data-x="attr-hyperlink-href">href</code> content
attribute, the <code data-x="dom-draggable">draggable</code> IDL attribute must return true;
otherwise, the <code data-x="dom-draggable">draggable</code> IDL attribute must return false.</p>

<p>If the <code data-x="dom-draggable">draggable</code> IDL attribute is set to the value false,
the <code data-x="attr-draggable">draggable</code> content attribute must be set to the literal
Expand Down

0 comments on commit 17402ca

Please sign in to comment.