Merge pull request #270 from eladalon1983/main

Define "focus-capturing-application"
w3c · Jun 29, 2023 · 30d0ea6 · 30d0ea6
2 parents f24b24a + bc38153
commit 30d0ea6
Showing 1 changed file with 17 additions and 2 deletions.
diff --git a/index.html b/index.html
@@ -805,6 +805,7 @@ <h2><dfn>CaptureStartFocusBehavior</dfn></h2>
           </p>
           <pre class="idl">
             enum CaptureStartFocusBehavior {
+              "focus-capturing-application",
               "focus-captured-surface",
               "no-focus-change"
             };    
@@ -816,6 +817,14 @@ <h2><dfn>CaptureStartFocusBehavior</dfn></h2>
                   Enumeration description
                 </th>
               </tr>
+              <tr>
+                <td style="white-space:nowrap">
+                  <dfn id="idl-def-CaptureStartFocusBehavior.focus-capturing-application">focus-capturing-application</dfn>
+                </td>
+                <td>
+                  The application prefers to be focused.
+                </td>
+              </tr>
               <tr>
                 <td style="white-space:nowrap">
                   <dfn id="idl-def-CaptureStartFocusBehavior.focus-captured-surface">focus-captured-surface</dfn>
@@ -830,11 +839,17 @@ <h2><dfn>CaptureStartFocusBehavior</dfn></h2>
                   <dfn id="idl-def-CaptureStartFocusBehavior.no-focus-change">no-focus-change</dfn>
                 </td>
                 <td>
-                  The application prefers that the user agent not change focus.
+                  The application prefers that the user agent not change focus, leaving focus
+                  with whichever surface last had focus following the user's interaction with
+                  the user agent and/or operating system.
                 </td>
               </tr>
             </tbody>
           </table>
+          <div class="note">
+            The Working Group is investigating the possibility of 
+            deprecating {{CaptureStartFocusBehavior/"no-focus-change"}}.
+          </div>
         </section>
         <section>
           <h2><dfn>CaptureController</dfn></h2>
@@ -1032,7 +1047,7 @@ <h2><dfn>CaptureController</dfn></h2>
                 <li>
                   <p>
                     If <var>controller</var>.{{CaptureController/[[FocusBehavior]]}}
-                    is {{CaptureStartFocusBehavior/"no-focus-change"}},
+                    is {{CaptureStartFocusBehavior/"focus-capturing-application"}},
                     focus the [=display surface=] representing the capturing document.
                   </p>
                 </li>