Update source

whatwg · Mar 3, 2023 · 2f0b55e · 2f0b55e
1 parent d64d380
commit 2f0b55e
Showing 1 changed file with 37 additions and 27 deletions.
diff --git a/source b/source
@@ -82121,22 +82121,22 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
    <p>The <span>topmost popover ancestor</span> algorithm will return the topmost (latest in the
    <span>auto popover list</span>) ancestor popover for the provided popover. Popovers can be
    related to each other in several ways, creating a tree of popovers. There are two paths through
-   which one popover (call it the "child" popover) can have an ancestor popover (call it the
+   which one popover (call it the "child" popover) can have a topmost ancestor popover (call it the
    "parent" popover):</p>
 
    <ol>
-    <li><p>The popovers are nested within each other in the DOM tree. In this case, the descendant
-    popover is the "child" and its ancestor popover is the "parent".</p></li>
+    <li><p>The popovers are nested within each other in the node tree. In this case, the descendant
+    popover is the "child" and its topmost ancestor popover is the "parent".</p></li>
 
-    <li><p>An invoking element (e.g. a <code>button</code>) has a <code
+    <li><p>An invoking element (e.g., a <code>button</code>) has a <code
     data-x="attr-popovertarget">popovertarget</code> attribute pointing to a popover. In this case,
-    the popover is the "child", and the DOM-contained popover of the invoking element is the
-    "parent". The invoker must be in a popover and reference an open popover.</p></li>
+    the popover is the "child", and the popover subtree the invoking element is in is the
+    "parent". The invoker has to be in a popover and reference an open popover.</p></li>
    </ol>
 
-   <p>In each of the relationships formed above, the parent popover must be strictly earlier in the
-   <span>auto popover list</span> than the child popover, or it does not form a valid ancestral
-   relationship. This eliminates non-showing popovers and self-pointers (e.g. a popover with an
+   <p>In each of the relationships formed above, the parent popover has to be strictly earlier in
+   the <span>auto popover list</span> than the child popover, or it does not form a valid ancestral
+   relationship. This eliminates non-showing popovers and self-pointers (e.g., a popover with an
    anchor attribute that points back to the same popover), and it allows for the construction of a
    well-formed tree from the (possibly cyclic) graph of connections. For example, if two popovers
    have anchors pointing to each other, the only valid relationship is that the first one to open is
@@ -82338,24 +82338,34 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
   <p>The <code data-x="attr-popovertargetaction">popovertargetaction</code> attribute is an
   <span>enumerated attribute</span> with the following keywords and states:</p>
 
-  <ul>
-   <li>The "<dfn attr-value for="html-global/popovertargetaction"
-   data-x="attr-popovertargetaction-toggle"><code>toggle</code></dfn>" keyword and corresponding
-   state.</li>
-
-   <li>The "<dfn attr-value for="html-global/popovertargetaction"
-   data-x="attr-popovertargetaction-show"><code>show</code></dfn>" keyword and corresponding
-   state.</li>
-
-   <li>The "<dfn attr-value for="html-global/popovertargetaction"
-   data-x="attr-popovertargetaction-hide"><code>hide</code></dfn>" keyword and corresponding
-   state.</li>
-  </ul>
+  <table>
+   <thead>
+    <tr>
+     <th>Keyword
+     <th>State
+     <th>Brief description
+   <tbody>
+    <tr>
+     <td>"<dfn attr-value for="html-global/popovertargetaction"
+     data-x="attr-popovertargetaction-toggle"><code>toggle</code></dfn>"
+     <td><dfn data-x="attr-popovertargetaction-toggle-state">toggle</dfn>
+     <td>Shows or hides the targeted popover element.
+    <tr>
+     <td>"<dfn attr-value for="html-global/popovertargetaction"
+     data-x="attr-popovertargetaction-show"><code>show</code></dfn>"
+     <td><dfn data-x="attr-popovertargetaction-show-state">show</dfn>
+     <td>Shows the targeted popover element.
+    <tr>
+     <td>"<dfn attr-value for="html-global/popovertargetaction"
+     data-x="attr-popovertargetaction-hide"><code>hide</code></dfn>"
+     <td><dfn data-x="attr-popovertargetaction-hide-state">hide</dfn>
+     <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 <code
-  data-x="attr-popovertargetaction-toggle">toggle</code> state.</p>
+  default">missing value default</i> are both the <span
+  data-x="attr-popovertargetaction-toggle-state">toggle</span> state.</p>
 
   <div class="example">
    <p>The following shows how the <code data-x="attr-popovertarget">popovertarget</code> attribute
@@ -82395,7 +82405,7 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
   <p>The <dfn attribute for="HTMLElement"><code
   data-x="dom-popoverTargetAction">popoverTargetAction</code></dfn> IDL attribute must
   <span>reflect</span> the <code data-x="attr-popovertargetaction">popovertargetaction</code>
-  attribute.</p>
+  attribute, <span>limited to only known values</span>.</p>
 
   <p>To run the <dfn>popover target attribute activation behavior</dfn> given a <code>Node</code>
   <var>node</var>:</p>
@@ -82406,12 +82416,12 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
    <li><p>If <var>popover</var> is null, then return.</p></li>
 
    <li><p>If <var>node</var>'s <code data-x="attr-popovertargetaction">popovertargetaction</code>
-   attribute is in the <code data-x="attr-popovertargetaction-show">show</code> state and
+   attribute is in the <span data-x="attr-popovertargetaction-show">show</span> state and
    <var>popover</var>'s <span>popover visibility state</span> is <span
    data-x="popover-showing-state">showing</span>, then return.</p></li>
 
    <li><p>If <var>node</var>'s <code data-x="attr-popovertargetaction">popovertargetaction</code>
-   attribute is in the <code data-x="attr-popovertargetaction-hide">hide</code> state and
+   attribute is in the <span data-x="attr-popovertargetaction-hide">hide</span> state and
    <var>popover</var>'s <span>popover visibility state</span> is <span
    data-x="popover-hidden-state">hidden</span>, then return.</p></li>