From a22f2866b7dfc96bc56608a26b197c98df7ed390 Mon Sep 17 00:00:00 2001
From: Scott O'Hara <scottaohara@users.noreply.github.com>
Date: Thu, 7 Nov 2024 16:40:13 -0500
Subject: [PATCH] add naming steps for option

this commit also contains commented out content to address https://github.com/w3c/html-aam/issues/568 in a future PR
---
 html-aam/index.html | 35 ++++++++++++++++++++++++++++++++++-
 1 file changed, 34 insertions(+), 1 deletion(-)

diff --git a/html-aam/index.html b/html-aam/index.html
index 6fd0d4388..8cb50cb54 100644
--- a/html-aam/index.html
+++ b/html-aam/index.html
@@ -11705,6 +11705,10 @@ <h4 id="att-label">`label`</h4>
               <td>
                 The target element of the `label` attribute has a `LabeledBy` property pointing to the element with the `label` attribute. Participates in
                 <a href="#accname-computation">name computation.</a>
+                <!--
+                  This UIA definition doesn't seem right.  May replace with:
+                  <div class="name">Associates the <a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a></div>
+                -->  
               </td>
             </tr>
             <tr>
@@ -11719,7 +11723,12 @@ <h4 id="att-label">`label`</h4>
             </tr>
             <tr>
               <th>Comments</th>
-              <td>See Also: <a href="" class="accname">Accessible Name and Description: Computation and API Mappings 1.1</a></td>
+              <td>
+               <!-- 
+                FOR FUTURE PR https://github.com/w3c/html-aam/issues/568 :
+                The `label` attribute can also participate in the <a data-cite="accname-1.2/#dfn-accessible-description">accessible descriptions</a> of
+                an `option`, if the `option` is a child of a `datalist`. See <a href="#accdesc-computation">accessible description computation</a> for more information. -->
+              </td>
             </tr>
           </tbody>
         </table>
@@ -16154,6 +16163,26 @@ <h4>`fieldset` Element Accessible Name Computation</h4>
             <li>Otherwise, there is no <a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a>.</li>
           </ol>
         </section>
+        <section>
+          <h4>`option` Element Accessible Name Computation</h4>
+          <ol>
+            <li>
+              If the `option` element has an <a data-cite="wai-aria-1.2/#aria-label">`aria-label`</a> or an <a data-cite="wai-aria-1.2/#aria-labelledby">`aria-labelledby`</a> attribute the
+              <a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a> is to be calculated using the algorithm defined in
+              <a href="" class="accname">Accessible Name and Description: Computation and API Mappings</a>.
+            </li>
+            <li>
+              If the <a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a> is still empty, then: use the value of the `option` element's `label` attribute.
+            </li>
+            <li>Otherwise if no `label` attribute is specified use the `option` element subtree.</li>
+            <li>Otherwise use `title` attribute.</li>
+            <li>If none of the above yield a usable text string there is no <a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a>.</li>
+          </ol>
+          <p class="note">
+            An `option` element's `label` attribute will override the rendering of an `option` element's author defined descendents. Instead, the 
+            value of the element's `label` attribute is used as the visible text label for the `option`.
+          </p>
+        </section>
         <section>
           <h4>`output` Element Accessible Name Computation</h4>
           <ol>
@@ -16364,6 +16393,10 @@ <h3>Accessible Description Computation</h3>
                 an `input` element whose `type` attribute is the `button`, `submit` or `reset` state, and it has a `value` attribute, then use the flat string of the attribute if it was not used as
                 the <a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a>.
               </li>
+              <!--
+                FOR FUTURE PR https://github.com/w3c/html-aam/issues/568 : 
+                add what to do for an option with a label attribute and inner text content, when used within the context of a datalist
+              -->
             </ul>
           </li>
           <li>Otherwise, use the flat string of the `title` attribute if it was not used as the <a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a> for the element.</li>