From 6cca5e65c37a164aecef9c1457c8c45c4faf37f2 Mon Sep 17 00:00:00 2001 From: Rami Yushuvaev Date: Thu, 14 Sep 2023 11:18:39 -0700 Subject: [PATCH 1/2] Update landmark roles - add HTML `` element --- files/en-us/web/accessibility/aria/roles/index.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/files/en-us/web/accessibility/aria/roles/index.md b/files/en-us/web/accessibility/aria/roles/index.md index ea66456adb4fa9f..85e660591c9f664 100644 --- a/files/en-us/web/accessibility/aria/roles/index.md +++ b/files/en-us/web/accessibility/aria/roles/index.md @@ -103,13 +103,13 @@ Note that there is also a widget role (`role="widget"`), which is an abstract ro Landmark roles provide a way to identify the organization and structure of a web page. By classifying and labeling sections of a page, structural information conveyed visually through layout is represented programmatically. Screen readers use landmark roles to provide keyboard navigation to important sections of a page. Use these sparingly. Too many landmark roles create "noise" in screen readers, making it difficult to understand the overall layout of the page. - [banner](/en-US/docs/Web/Accessibility/ARIA/Roles/banner_role) (document {{HTMLElement('header')}}) -- [complementary](/en-US/docs/Web/Accessibility/ARIA/Roles/complementary_role) ({{HTMLElement('aside')}}) - [contentinfo](/en-US/docs/Web/Accessibility/ARIA/Roles/contentinfo_role) (document {{HTMLElement('footer')}}) -- [form](/en-US/docs/Web/Accessibility/ARIA/Roles/form_role) ({{HTMLElement('form')}}) - [main](/en-US/docs/Web/Accessibility/ARIA/Roles/main_role) ({{HTMLElement('main')}}) -- [navigation](/en-US/docs/Web/Accessibility/ARIA/Roles/navigation_role) ({{HTMLElement('nav')}}) +- [complementary](/en-US/docs/Web/Accessibility/ARIA/Roles/complementary_role) ({{HTMLElement('aside')}}) - [region](/en-US/docs/Web/Accessibility/ARIA/Roles/region_role) ({{HTMLElement('section')}}) -- [search](/en-US/docs/Web/Accessibility/ARIA/Roles/search_role) +- [navigation](/en-US/docs/Web/Accessibility/ARIA/Roles/navigation_role) ({{HTMLElement('nav')}}) +- [form](/en-US/docs/Web/Accessibility/ARIA/Roles/form_role) ({{HTMLElement('form')}}) +- [search](/en-US/docs/Web/Accessibility/ARIA/Roles/search_role) ({{HTMLElement('search')}}) ### 4. Live region roles From d3896ee5bc23ce00a63c9bae40c5a14ec1aef1b4 Mon Sep 17 00:00:00 2001 From: Rami Yushuvaev Date: Thu, 14 Sep 2023 13:46:41 -0700 Subject: [PATCH 2/2] code review --- files/en-us/web/accessibility/aria/roles/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/files/en-us/web/accessibility/aria/roles/index.md b/files/en-us/web/accessibility/aria/roles/index.md index 85e660591c9f664..16b0215c9b7ca7a 100644 --- a/files/en-us/web/accessibility/aria/roles/index.md +++ b/files/en-us/web/accessibility/aria/roles/index.md @@ -103,12 +103,12 @@ Note that there is also a widget role (`role="widget"`), which is an abstract ro Landmark roles provide a way to identify the organization and structure of a web page. By classifying and labeling sections of a page, structural information conveyed visually through layout is represented programmatically. Screen readers use landmark roles to provide keyboard navigation to important sections of a page. Use these sparingly. Too many landmark roles create "noise" in screen readers, making it difficult to understand the overall layout of the page. - [banner](/en-US/docs/Web/Accessibility/ARIA/Roles/banner_role) (document {{HTMLElement('header')}}) +- [complementary](/en-US/docs/Web/Accessibility/ARIA/Roles/complementary_role) ({{HTMLElement('aside')}}) - [contentinfo](/en-US/docs/Web/Accessibility/ARIA/Roles/contentinfo_role) (document {{HTMLElement('footer')}}) +- [form](/en-US/docs/Web/Accessibility/ARIA/Roles/form_role) ({{HTMLElement('form')}}) - [main](/en-US/docs/Web/Accessibility/ARIA/Roles/main_role) ({{HTMLElement('main')}}) -- [complementary](/en-US/docs/Web/Accessibility/ARIA/Roles/complementary_role) ({{HTMLElement('aside')}}) -- [region](/en-US/docs/Web/Accessibility/ARIA/Roles/region_role) ({{HTMLElement('section')}}) - [navigation](/en-US/docs/Web/Accessibility/ARIA/Roles/navigation_role) ({{HTMLElement('nav')}}) -- [form](/en-US/docs/Web/Accessibility/ARIA/Roles/form_role) ({{HTMLElement('form')}}) +- [region](/en-US/docs/Web/Accessibility/ARIA/Roles/region_role) ({{HTMLElement('section')}}) - [search](/en-US/docs/Web/Accessibility/ARIA/Roles/search_role) ({{HTMLElement('search')}}) ### 4. Live region roles