From 66344b0d9edb0985adcd1805692a366d85d33ebc Mon Sep 17 00:00:00 2001 From: Alastair Campbell Date: Sat, 8 Aug 2020 22:40:05 +0100 Subject: [PATCH 1/7] Updates from issue 291 --- techniques/aria/ARIA11.html | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/techniques/aria/ARIA11.html b/techniques/aria/ARIA11.html index 6e65bb3edd..afc5a3104b 100644 --- a/techniques/aria/ARIA11.html +++ b/techniques/aria/ARIA11.html @@ -5,7 +5,7 @@

They also provide an easy way for users of assistive technology to skip over blocks of content that are repeated on multiple pages and notify them of programmatic structure of a page. For instance, if there is a common navigation menu found on every page, landmark roles (or "landmarks") can be used to skip over it and navigate from section to section. This will save assistive technology users and keyboard users the trouble and time of tabbing through a large amount of content to find what they are really after, much like a traditional "skip links" mechanism. (Refer to User Agent Notes above for specifics of AT support). A blind user who may be familiar with a news site's menu, and is only interested in getting to the top story could easily navigate to the "main" landmark, and bypass dozens of menu links. In another circumstance, a user who is blind may want to quickly find a navigation menu, and can do so by jumping to the navigation landmark.

-

Landmarks also can help sighted keyboard-only users navigate to sections of a page using a browser plugin. +

Landmarks also can help sighted keyboard-only users navigate to sections of a page using a browser plugin.

Landmarks are inserted into the page using the role attribute on an element that marks the section. The value of the attribute is the name of the landmark. These role values are listed below:

@@ -22,6 +22,8 @@
  • navigation: A collection of links suitable for use when navigating the document or related documents.
    • +
  • region: A region of content for an author-specific purpose that is important for users to be able to navigate to. It maps to section in HTML5, and needs a label to be included as a landmark for assistive technology.
    • +
  • search: The search tool of a Web document.
    • @@ -71,7 +73,7 @@

    Multiple landmarks of the same type and aria-label

    Search form

    -

    The following example shows a search form with a "search" landmark. The search role typically goes on the form field or a div surrounding the search form.

    +

    The following example shows a search form with a "search" landmark. The search role typically goes on the form element or a div surrounding the search form.

    <form role="search">
 <label for="s6">search</label><input id="s6" type="text" size="20">
 ...
@@ -101,7 +103,7 @@ 
    Search form
    
       
          
      
             
    • 
-                  WAI-ARIA Authoring Practices 1.1 
+                  WAI-ARIA Authoring Practices 
                
      • 
             
    • 
                   Accessible Rich Internet Applications (WAI-ARIA) 1.0, Using WAI-ARIA Roles
@@ -110,7 +112,7 @@ 
      Search form
      
                   Accessible Rich Internet Applications (WAI-ARIA) 1.0, Supported States and Properties
                
      • 
             
    • 
-                  Enabling landmark-based keyboard navigation in Firefox
+                  Enabling landmark-based keyboard navigation in Firefox
                
      • 
             
    • 
                Landmarks browser extension

From 526b1a49e3e70272077cb2b94f0687c187d7da95 Mon Sep 17 00:00:00 2001
From: Mike Gower 
Date: Tue, 9 Nov 2021 13:31:06 -0800
Subject: [PATCH 2/7] Update techniques/aria/ARIA11.html

Co-authored-by: Carolyn MacLeod 
---
 techniques/aria/ARIA11.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/techniques/aria/ARIA11.html b/techniques/aria/ARIA11.html
index afc5a3104b..6d20700421 100644
--- a/techniques/aria/ARIA11.html
+++ b/techniques/aria/ARIA11.html
@@ -22,7 +22,7 @@
 
      • 
          
    • navigation: A collection of links suitable for use when navigating the document or related documents.
 
      • 
-         
    • region: A region of content for an author-specific purpose that is important for users to be able to navigate to. It maps to section in HTML5, and needs a label to be included as a landmark for assistive technology.
      • 
+         
    • region: A region of content for an author-specific purpose that is important for users to be able to navigate to. It maps to section in HTML5, and needs an accessible label to be included as a landmark for assistive technology.
      • 
 
          
    • search: The search tool of a Web document.
 
      • 

From ff70689409df8da8c93e127c8309c0c98caee84f Mon Sep 17 00:00:00 2001
From: Mike Gower 
Date: Tue, 9 Nov 2021 13:56:34 -0800
Subject: [PATCH 3/7] Update ARIA11.html

Attempt to better address the relationship between region and html5 section
---
 techniques/aria/ARIA11.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/techniques/aria/ARIA11.html b/techniques/aria/ARIA11.html
index 6d20700421..82fa965ba9 100644
--- a/techniques/aria/ARIA11.html
+++ b/techniques/aria/ARIA11.html
@@ -16,7 +16,7 @@
 
          
    • contentinfo:  A region that contains information about the parent document such as copyrights and links to privacy statements.
 
      • 
-         
    • form: A region of the document that represents a collection of form-associated elements, some of which can represent editable values that can be submitted to a server for processing.
+         
    • form:  A region of content for an author-specific purpose that is important for users to be able to navigate to. In HTML5, `section` with an accessible label maps to the region role. The region role needs an accessible label to be included as a landmark for assistive technology.
 
      • 
          
    • main: Main content in a document. In almost all cases a page will have only one role="main".
 
      • 
@@ -119,4 +119,4 @@ 
      Search form
      
             
          
    
       
-
    \ No newline at end of file + From a108fa74ae92690a439da14b37e88c4962ea4f16 Mon Sep 17 00:00:00 2001 From: Mike Gower Date: Tue, 9 Nov 2021 14:02:55 -0800 Subject: [PATCH 4/7] Update ARIA11.html altered form by accident. moving update to the region list item --- techniques/aria/ARIA11.html | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/techniques/aria/ARIA11.html b/techniques/aria/ARIA11.html index 82fa965ba9..955bed485f 100644 --- a/techniques/aria/ARIA11.html +++ b/techniques/aria/ARIA11.html @@ -16,13 +16,14 @@
  • contentinfo: A region that contains information about the parent document such as copyrights and links to privacy statements.
    • -
  • form: A region of content for an author-specific purpose that is important for users to be able to navigate to. In HTML5, `section` with an accessible label maps to the region role. The region role needs an accessible label to be included as a landmark for assistive technology. +
  • form: form: A region of the document that represents a collection of form-associated elements, some of which can represent editable values that can be submitted to a server for processing.
  • main: Main content in a document. In almost all cases a page will have only one role="main".
  • navigation: A collection of links suitable for use when navigating the document or related documents.
    • -
  • region: A region of content for an author-specific purpose that is important for users to be able to navigate to. It maps to section in HTML5, and needs an accessible label to be included as a landmark for assistive technology.
    • +
  • region: A generic region of content to which, for an author-specific purpose, it is important for users to be able to navigate. In HTML5, `section` with an accessible label maps to the region role. The region role needs an accessible label to be included as a landmark for assistive technology. +
  • search: The search tool of a Web document.
    • From d60fb1473a8e84d78fe0c2f07409b545e689f6db Mon Sep 17 00:00:00 2001 From: Mike Gower Date: Tue, 9 Nov 2021 14:04:39 -0800 Subject: [PATCH 5/7] Update ARIA11.html fixed another glitch with my change --- techniques/aria/ARIA11.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/techniques/aria/ARIA11.html b/techniques/aria/ARIA11.html index 955bed485f..1decebb291 100644 --- a/techniques/aria/ARIA11.html +++ b/techniques/aria/ARIA11.html @@ -16,7 +16,7 @@
  • contentinfo: A region that contains information about the parent document such as copyrights and links to privacy statements.
    • -
  • form: form: A region of the document that represents a collection of form-associated elements, some of which can represent editable values that can be submitted to a server for processing. +
  • form: A region of the document that represents a collection of form-associated elements, some of which can represent editable values that can be submitted to a server for processing.
  • main: Main content in a document. In almost all cases a page will have only one role="main".
    • From 155f0bbf217e3f73784876679e3158b297a093e4 Mon Sep 17 00:00:00 2001 From: Alastair Campbell Date: Wed, 10 May 2023 11:45:35 +0100 Subject: [PATCH 6/7] Link updated. --- techniques/aria/ARIA11.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/techniques/aria/ARIA11.html b/techniques/aria/ARIA11.html index 1decebb291..eb7fad0658 100644 --- a/techniques/aria/ARIA11.html +++ b/techniques/aria/ARIA11.html @@ -113,7 +113,7 @@

    Search form

    Accessible Rich Internet Applications (WAI-ARIA) 1.0, Supported States and Properties
  • - Enabling landmark-based keyboard navigation in Firefox + Enabling landmark-based keyboard navigation in Firefox
  • Landmarks browser extension From 7647588eab54e2bc9f7ac3f72d3fa999b29aae17 Mon Sep 17 00:00:00 2001 From: Alastair Campbell Date: Wed, 10 May 2023 11:45:52 +0100 Subject: [PATCH 7/7] Update techniques/aria/ARIA11.html Co-authored-by: Carolyn MacLeod --- techniques/aria/ARIA11.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/techniques/aria/ARIA11.html b/techniques/aria/ARIA11.html index eb7fad0658..4b0c3fa87d 100644 --- a/techniques/aria/ARIA11.html +++ b/techniques/aria/ARIA11.html @@ -22,7 +22,7 @@
  • navigation: A collection of links suitable for use when navigating the document or related documents.
    • -
  • region: A generic region of content to which, for an author-specific purpose, it is important for users to be able to navigate. In HTML5, `section` with an accessible label maps to the region role. The region role needs an accessible label to be included as a landmark for assistive technology. +
  • region: A generic region of content to which, for an author-specific purpose, it is important for users to be able to navigate. In HTML, `section` with an accessible label maps to the region role. The region role needs an accessible label to be included as a landmark for assistive technology.
  • search: The search tool of a Web document.