From 450ccf98bc80c25f9e9e046c2392c2af04bac164 Mon Sep 17 00:00:00 2001
From: Scott O'Hara <scottaohara@users.noreply.github.com>
Date: Wed, 8 Mar 2023 15:12:03 -0500
Subject: [PATCH] Clarify mappings for contenteditable

Per discussion around the minimum role concept, and the WG deciding that contentedtiable should remain unmapped to any specific ARIA role when used on a generic.    per that decision #324 is closed, but the other clarifications that were to be a part of that PR are now in this one.

Additionally, there are other necessary updates needed for these mappings, as the previous ones did not get into the nuance of how to handle nested `contenteditable` attributes.
---
 index.html | 31 ++++++++++++++++++++++++-------
 1 file changed, 24 insertions(+), 7 deletions(-)

diff --git a/index.html b/index.html
index 8d2046f3..e4b7b562 100644
--- a/index.html
+++ b/index.html
@@ -3658,31 +3658,48 @@ <h3>HTML Attribute State and Property Mappings</h3>
               <td class="elements">
                 <a data-cite="html/interaction.html#attr-contenteditable">HTML elements</a>
               </td>
-              <td class="aria">?</td>
+              <td class="aria">
+                <!--<p>If in the `true`, `false` or `inherit` state: -->Not mapped<!--</p>
+                <p>If in the `plaintext-only` state: see comments</p>  -->
+              </td>
               <td class="ia2">
+                <p>If the element is in the editable state, the following mappings apply to the element and every nested accessible object with the 
+                exception of those which have been specified in the `false` state.</p>
                 <div class="states">
                   <span class="type">States:</span>
-                  `IA2_STATE_EDITABLE` on this and every nested text accessible object
+                  `IA2_STATE_EDITABLE` and `IA2_STATE_MULTI_LINE`
                 </div>
                 <div class="interfaces">
                   <span class="type">Interfaces:</span>
-                  `IAccessibleEditableText` on this and every nested text accessible object
+                  `IAccessibleEditableText`
                 </div>
+                <p>If the element is in the `false` state: not mapped.</p>
+                <p>If the element is in the `inherit` state: match the editable state of its parent element.</p>
               </td>
               <td class="uia">
+                <p>If the element is in the editable state, the following mappings apply to the element and every nested accessible object with the 
+                exception of those which have been specified in the `false` state.</p>
                 <div class="ctrltype">
                   <span class="type">Control Pattern:</span> `TextEdit`
                 </div>
+                <div class="property">
+                  <span class="type">Property:</span> `AriaProperties.multiline:true`
+                </div>
+                <p>If the element is in the `false` state: not mapped.</p>
+                <p>If the element is in the `inherit` state: match the editable state of its parent element.</p>
               </td>
               <td class="atk">
+                <p>If the element is in the editable state, the following mappings apply to the element and every nested accessible object with the 
+                exception of those which have been specified in the `false` state.</p>
                 <div class="states">
                   <span class="type">States:</span>
-                  `ATK_STATE_EDITABLE` on this and every nested text accessible object.
+                  `ATK_STATE_EDITABLE` and `ATK_STATE_MULTI_LINE`
                 </div>
                 <div class="interfaces">
-                  <span class="type">Interfaces:</span>
-                  `AtkEditableText` on this and every nested text accessible object.
+                  <span class="type">Interfaces:</span> `AtkEditableText`
                 </div>
+                <p>If the element is in the `false` state: not mapped.</p>
+                <p>If the element is in the `inherit` state: match the editable state of its parent element.</p>
               </td>
               <td class="ax">
                 <span class="type">Role:</span>
@@ -3690,7 +3707,7 @@ <h3>HTML Attribute State and Property Mappings</h3>
                 <div class="general">Use WAI-ARIA mapping</div>
               </td>
               <td class="comments">
-                If the element has the `contenteditable` attribute  and `aria-readonly="true"`, User Agents MUST expose only the `contenteditable` state.
+                If the element is set to `contenteditable`  and `aria-readonly="true"`, User Agents MUST expose only the `contenteditable` state.
               </td>
             </tr>
             <tr tabindex="-1" id="att-controls">