Merge branch 'main' into patrickhlauke-pointer-gesture-dragging-disambiguation

Author: patrickhlauke

package-lock.json

@@ -131,9 +131,8 @@ <h3>Expected Results</h3>
   </section>
   <section id="related">
     <h2>Related Techniques</h2>
-    <p>Currently none.</p>
     <ul>
-      <li>ID</li>
+      <li><a href="../failures/F95.html">F95</a></li>
     </ul>
   </section>
 </body>

techniques/client-side-script/SCR39.html

@@ -52,12 +52,16 @@ <h3>Procedure</h3>
             </ul>
           </li>
           <li>
-            <p>Dismiss the menu or dialog</p>
-            <ul>
-              <li>Check whether focus is on the trigger control.</li>
-              <li>If focus needs to be placed on a different control, check whether that different control is logical.</li>
-            </ul>
-          </li>
+            <p>Activate a control in the menu or dialog that causes it to close. This could be a cancel or delete button or another action that causes changes to the page and at the same time closes the menu or dialog.</p>
+          <ul>
+             <li>
+                <p>Check whether keyboard focus is put back on the trigger control</p>
+               <li>
+               <li>
+                 <p>If the trigger control itself was removed as a result of the activation, check if the focus has been put on the interactive element immediately preceding or following the removed trigger control, or wherever is logical.</p>
+               </li>     
+          </ul>
+          </li>          
         </ol>
       </section>
       <section class="results">

techniques/failures/F85.html

@@ -57,7 +57,7 @@ <h3>Expected Results</h3>
 		<section id="related">
 			<h2>Related Techniques</h2>
 			<ul>
-				<li>ID</li>
+				<li><a href="../client-side-script/SCR39.html">SCR39</a></li>
 			</ul>
 		</section>
 	</body>

techniques/failures/F95.html

@@ -8,7 +8,7 @@
       <p>Information on how to find sign language interpreters is listed in the resources section below.</p>
       <div class="note">
          <p>If the video stream is too small, the sign language interpreter will be indiscernible. When creating a video stream that includes a video of a sign language interpreter, make sure there is a mechanism to play the video stream full screen in the accessibility-supported content technology. Otherwise, be sure the interpreter portion of the video is adjustable to the size it would be had the entire video stream been full screen.</p>
-         <p>Since sign language is not usually a signed version of the printed language, the author has to decide which sign language to include. Usually the sign language of the primary audience would be used. If intended for multiple audiences, multiple sign languages may be used. Refer to advisory techniques for multiple sign languages.</p>
+         <p>Since sign language is not usually a signed version of the printed language, the author has to decide which sign language to include. Usually the sign language of the primary audience would be used. If intended for multiple audiences, multiple sign languages may be used.</p>
       </div>
    </section><section id="examples"><h2>Examples</h2>
       <ul>

techniques/general/G160.html

@@ -5,7 +5,7 @@
    </section><section id="examples"><h2>Examples</h2>
       <ul>
          <li>A search engine has a form field for search terms. When the form is submitted, a server-side application checks the spelling. If the spelling doesn't match any words for that language, it sends back a page with a text message at the top saying "Did you mean ..." with a link to the suggested word. If the user clicks on the link the suggested term is entered into the form field and is resubmitted.</li>
-         <li>An airline has a on online ticket purchasing application. When a user types the name of a city into the form field a dropdown menu shows the closest match to the city in the top of the menu and other suggestions below.</li>
+         <li>An airline has an online ticket purchasing application. When a user types the name of a city into the form field a dropdown menu shows the closest match to the city in the top of the menu and other suggestions below.</li>
       </ul>
    </section><section id="tests"><h2>Tests</h2>
       <section class="procedure"><h3>Procedure</h3>

techniques/general/G194.html

@@ -17,16 +17,26 @@ <h2>When to Use</h2>
 		</section>
 		<section id="description">
 			<h2>Description</h2>
-			<p>The objective of this technique is to provide a warning before automatically
-            opening a new window or tab. Opening new windows automatically when
-            a link is activated can be disorienting for people who have difficulty
+			<p>The objective of this technique is to provide advanced warning for links and buttons that open a new 
+            window or tab when activated by the user. This only applies to "regular" activation, such as 
+            a left-click on a mouse, or pressing <kbd>Enter</kbd> or <kbd>Space</kbd> when the link or button has
+            focus – actions that normally would open the link target in the current tab or window, trigger an action
+            on the current page, or result in a form submission and a loading a confirmation page in in the current tab or window.
+            The technique does not apply to situations where the user explicitly chooses to open a new tab or window – for instance,
+            when using the browser's context menu option, or middle-clicking a link with the mouse.</p>
+            <p>Opening a new tab or window when
+            a link or button is activated can be disorienting for people who have difficulty
             perceiving visual content, and for some people with cognitive disabilities,
-            if they are not warned in advance. Providing a warning allows the user
-            to decide it they want to leave the current window, and the warning
-            will help them find their way back, if they do decide they would like
-            to go to the new window. It will help them understand that the "back" button
-            will not work and that they have to return to the last window they
+            if they are not warned in advance. Providing a warning or indication that a new tab or window
+            will be opened allows the user to decide it they want to leave the current tab or window. It will also help
+            them understand that, once they follow they activate the link or button, their browser's "back" button
+            will not work and that they have to return to the last tab or window they
             had open, in order to find their previous location.</p>
+            <div class="note">
+              <p>This technique is advisory. While indicating that a link or button
+                "opens in a new window" is considered good practice, it is not necessary
+                to meet the requirements of any particular success criterion.</p>
+            </div>
 					</section>
 					<section id="examples">
 						<h2>Examples</h2>
@@ -39,11 +49,12 @@ <h3>Including the warning in the text describing a control</h3>
 &lt;/a&gt;</code></pre>
       </section>
       <section class="example">
-         <h3>Using CSS to provide a warning before opening a new window</h3>
-         
-            <p>The code below uses CSS to provide a warning before opening a new
-                window.</p>
-         
+          <h3>Using an icon and accessible description to provide a warning before opening a new window</h3>
+
+          <p>The code below uses CSS to add an SVG icon to a link, providing a visual warning before opening a new
+            window. In addition, <code>aria-describedby</code> is used on the link to include an equivalent text warning
+            for assistive technology users.</p>
+
 <pre><code class="language-html">&lt;!DOCTYPE html&gt;
 &lt;html lang="en"&gt;
 &lt;head&gt;
@@ -84,35 +95,34 @@ <h3>Using CSS to provide a warning before opening a new window</h3>
      role="img"&gt;&lt;use href="#new-window-icon"&gt;&lt;/use&gt;&lt;/svg&gt;&lt;/a&gt;&lt;/p&gt;
   &lt;/body&gt;
 &lt;/html&gt;</code></pre>
-         
-<p class="working-example">A <a href="../../working-examples/css-new-window-warn/">working example of Using CSS to provide a warning before opening a new window</a> is available.</p>
-         
+
+<p class="working-example">A <a href="../../working-examples/css-aria-new-window-warn/">working example of Using an icon and accessible description to provide a warning before opening a new window</a> is available.</p>
+
       </section>
-   </section>
-   <section id="tests">
+  </section>
+  <section id="tests">
       <h2>Tests</h2>
       <section class="procedure">
-         <h3>Procedure</h3>
-         <p>For each link that opens automatically in a new window or tab when a change of context is initiated by a user request:</p>
-         <ol>
-            <li>Check that there is a warning spoken in assistive technology that this link opens to a new window.</li>
-            <li>Check that there is a visual warning in text that this link opens to a new window.</li>
-         </ol>
+        <h3>Procedure</h3>
+        <p>For each link or button that opens a new window or tab when activated:</p>
+        <ol>
+            <li>Check that there is a warning spoken in assistive technology that this control opens a new window.</li>
+            <li>Check that there is a visual warning/indication that this control opens a new window.</li>
+        </ol>
       </section>
       <section class="results">
-         <h3>Expected Results</h3>
-         <ul>
-            <li>Checks #1 and check #2 are true.</li>
-         </ul>
+        <h3>Expected Results</h3>
+        <ul>
+            <li>Checks #1 and #2 are true.</li>
+        </ul>
       </section>
-   </section>
-   <section id="related">
+    </section>
+    <section id="related">
       <h2>Related Techniques</h2>
       <ul>
-         <li><a href="../html/H83">H83</a></li>
-         <li><a href="../client-side-script/SCR24">SCR24</a></li>
-         <li><a href="../general/G200">G200</a></li>
+          <li><a href="../html/H83">H83</a></li>
+          <li><a href="../client-side-script/SCR24">SCR24</a></li>
       </ul>
-   </section>
+    </section>
 </body>
-</html>
+</html>

techniques/general/G200.html

@@ -6,7 +6,7 @@
       <p>One universally compatible way of doing this is to simply embed a video of the sign language interpreter in the video stream.   This has the disadvantage of providing a lower resolution image that cannot be easily enlarged without enlarging the entire image.</p>
       <div class="note">
          <p>If the video stream is too small, the sign language interpreter will be indiscernible. When creating a video stream that includes a video of a sign language interpreter, make sure there is a mechanism to play the video stream full screen in the accessibility-supported content technology. Otherwise, be sure the interpreter portion of the video is adjustable to the size it would be had the entire video stream been full screen.</p>
-         <p>Since sign language is not usually a signed version of the printed language, the author has to decide which sign language to include.  Usually the sign language of the primary audience would be used.  If intended for multiple audiences, multiple sign languages may be used.  Refer to advisory techniques for multiple sign languages.</p>
+         <p>Since sign language is not usually a signed version of the printed language, the author has to decide which sign language to include.  Usually the sign language of the primary audience would be used.  If intended for multiple audiences, multiple sign languages may be used.</p>
       </div>
    </section><section id="examples"><h2>Examples</h2>
       <ul>