Editorial: add th/scope enumerated attribute table

Helps with #9832.
whatwg · Nov 23, 2023 · f3e23c7 · f3e23c7
1 parent c540eaa
commit f3e23c7
Showing 1 changed file with 40 additions and 39 deletions.
diff --git a/source b/source
@@ -43521,49 +43521,50 @@ interface <dfn interface>HTMLTableCellElement</dfn> : <span>HTMLElement</span> {
   data-x="concept-cell">cell</span> in a table.</p>
 
   <p>The <code>th</code> element may have a <dfn element-attr for="th"><code
-  data-x="attr-th-scope">scope</code></dfn> content attribute specified. The <code
-  data-x="attr-th-scope">scope</code> attribute is an <span>enumerated attribute</span> with five
-  states, four of which have explicit keywords:</p>
+  data-x="attr-th-scope">scope</code></dfn> content attribute specified.</p>
 
-  <dl>
-   <dt>The <dfn attr-value for="th/scope"><code data-x="attr-th-scope-row">row</code></dfn> keyword,
-   which maps to the <i>row</i> state</dt>
-
-   <dd>The <i>row</i> state means the header cell applies to some of the subsequent cells in the
-   same row(s).</dd>
-
-   <dt>The <dfn attr-value for="th/scope"><code data-x="attr-th-scope-col">col</code></dfn> keyword,
-   which maps to the <i>column</i> state</dt>
-
-   <dd>The <i>column</i> state means the header cell applies to some of the subsequent cells in the
-   same column(s).</dd>
-
-   <dt>The <dfn attr-value for="th/scope"><code
-   data-x="attr-th-scope-rowgroup">rowgroup</code></dfn> keyword, which maps to the <i>row group</i>
-   state</dt>
-
-   <dd>The <i>row group</i> state means the header cell applies to all the remaining cells in the
-   row group. A <code>th</code> element's <code data-x="attr-th-scope">scope</code> attribute must
-   not be in the <span data-x="attr-th-scope-rowgroup">row group</span> state if the element is not
-   anchored in a <span data-x="concept-row-group">row group</span>.</dd>
+  <p>The <code data-x="attr-th-scope">scope</code> attribute is an <span>enumerated attribute</span>
+  with the following keywords and states:</p>
 
-   <dt>The <dfn attr-value for="th/scope"><code
-   data-x="attr-th-scope-colgroup">colgroup</code></dfn> keyword, which maps to the <i>column
-   group</i> state</dt>
-
-   <dd>The <i>column group</i> state means the header cell applies to all the remaining cells in the
-   column group. A <code>th</code> element's <code data-x="attr-th-scope">scope</code> attribute must
-   not be in the <span data-x="attr-th-scope-colgroup">column group</span> state if the element is
-   not anchored in a <span data-x="concept-column-group">column group</span>.</dd>
-
-   <dt>The <dfn attr-value for="th/scope" data-x="attr-th-scope-auto">auto</dfn> state</dt>
-
-   <dd>The <i>auto</i> state makes the header cell apply to a set of cells selected based on
-   context.</dd>
-  </dl>
+  <table>
+   <thead>
+    <tr>
+     <th>Keyword
+     <th>State
+     <th>Brief description
+   </thead>
+   <tbody>
+    <tr>
+     <td><dfn attr-value for="th/scope"><code data-x="attr-th-scope-row">row</code></dfn>
+     <td><dfn data-x="attr-th-scope-row-state">row</dfn>
+     <td>The header cell applies to some of the subsequent cells in the same row(s).
+    <tr>
+     <td><dfn attr-value for="th/scope"><code data-x="attr-th-scope-col">col</code></dfn>
+     <td><dfn data-x="attr-th-scope-column-state">column</dfn>
+     <td>The header cell applies to some of the subsequent cells in the same column(s).
+    <tr>
+     <td><dfn attr-value for="th/scope"><code data-x="attr-th-scope-rowgroup">rowgroup</code></dfn>
+     <td><dfn data-x="attr-th-scope-rowgroup-state">row group</dfn>
+     <td>The header cell applies to all the remaining cells in the row group.
+    <tr>
+     <td><dfn attr-value for="th/scope"><code data-x="attr-th-scope-colgroup">colgroup</code></dfn>
+     <td><dfn data-x="attr-th-scope-colgroup-state">column group</dfn>
+     <td>The header cell applies to all the remaining cells in the column group.
+    <tr>
+     <td><dfn attr-value for="th/scope"><code data-x="attr-th-scope-auto">auto</code></dfn>
+     <td><dfn data-x="attr-th-scope-auto-state">auto</dfn>
+     <td>The header cell applies to a set of cells selected based on context.
+  </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 <i>auto</i> state.</p>
+  data-x="invalid value default">invalid value default</i> are both the <span
+  data-x="attr-th-scope-auto-state">auto</span> state.</p>
+
+  <p>A <code>th</code> element's <code data-x="attr-th-scope">scope</code> attribute must not be in
+  the <span data-x="attr-th-scope-rowgroup-state">row group</span> state if the element is not anchored in
+  a <span data-x="concept-row-group">row group</span>, nor in the <span
+  data-x="attr-th-scope-colgroup-state">column group</span> state if the element is not anchored in a
+  <span data-x="concept-column-group">column group</span>.
 
   <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