Skip to content

APG Website Change Log

Matt King edited this page Jan 16, 2024 · 1 revision

2023 APG Change Log

4 Commits That Changed the User Experience of Examples in 2023

Combobox Date Picker Example: Change previous and next month and year behavior for dates near end of month (pull #2618)

By Jon Gunderson on April 03, 2023

Provides partial resolution of #2581. The remainder of the resolution is provided by #2643.

This PR changes behavior of commands for next and previous month and year In the combobox date picker when the currently focused date does not exist in the previous or next month or year. With these changes, if the same day number does not exist in the newly displayed month, the last day of the newly displayed month receives focus.


Co-authored-by: Matt King [email protected]

View commit ce0336bd

Tablist Examples: Improve support for magnification (pull #2625)

By Jon Gunderson on April 10, 2023

Resolves #2284 and #2257 with the following changes:

  1. Changes CSS so it defines tab width as a percentage of screen width. This prevents screen magnification from causing horizontal scrolling. As the screen is magnified ,the height of the tabs increases and the tab content reflows to fit the new dimensions.
  2. Adds explanation of the use of percentage to the Accessibility Features section.

Co-authored-by: Matt King [email protected] Co-authored-by: Andrea N. Cardona [email protected]

View commit 9a729ec9

Datepicker Modal Dialog: Fixed next/prev month bug and improve adherence with APG code style guide (pull #2643)

By Jon Gunderson on June 06, 2023

This PR complements PR #2618 to provide the remaining changes to resolve issue #2581.

This PR changes behavior of commands for next and previous month and year In the date picker dialog when the currently focused date does not exist in the previous or next month or year. With these changes, if the same day number does not exist in the newly displayed month, the last day of the newly displayed month receives focus.

In addition to the above enhancement, this PR also includes the following changes:

  • Updates coding practices to use class constructor and pointer events
  • Updates documentation of page up and page down commands
  • Updates regression tests for page up and page down commands

Co-authored-by: Matt King [email protected]

View commit 32c7ef25

Rating Slider Example: Redesign as an input for 10-value satisfaction scale (pull #2831)

By Jon Gunderson on December 18, 2023

Resolves issue #2501 by modifying the rating slider example as follows:

  • Changes it to a 10-point scale from a 5-star scale that had half star ratings.
  • Changes the visual design to better represent common 10-point satisfaction sliders.
  • Improves the high contrast support.
  • Adds documentation that explains why the slider pattern is appropriate for this use case.

Co-authored-by: Andrea N. Cardona [email protected] Co-authored-by: Matt King [email protected]

View commit 7f54d962

11 Commits That Added or Changed Guidance in 2023

Carousel Examples: ad note informing authors that aria-rolesdescription uses the language of the page (pull #2358)

By Jon Gunderson on March 21, 2023

Fixes #2355 by:

Adding a note to the carousel examples that the aria-roledescription value uses the language of the page, similar to labeling of controls.


Co-authored-by: Matt King [email protected]

View commit d02c8121

Button Example: Add AT support tables from ARIA-AT (pull #2569)

By Alexander Flenniken on March 27, 2023

Adds a section to the button example page after the source code section that shows a table of screen reader support levels for the example. The data is pulled from the aria-at project (aria-at.w3.org) and displayed in an iframe.


Co-authored-by: Howard Edwards [email protected] Co-authored-by: Matt King [email protected]

View commit 914bcb9a

Add AT support tables to example pages for alert, link, and radio using activedescendant (pull #2653)

By Matt King on March 30, 2023

Updates three example pages to include a section for AT support:

  • Alert
  • Link
  • Radio Using aria-activedescendant

Co-authored-by: alflennik [email protected]

View commit 4f1d7702

About Page: Convert to an About section overview that links to several new pages within the about APG section (pull #2558)

By Matt King on April 11, 2023

Resolves #2423 by:

  • Moving content on About page to new subpages for Introduction, ARIA Basics, Acknowledgements, Change History, and References
  • Making the About page a landing page that provides links to the new subpages

Co-authored-by: JaEun Jemma Ku [email protected] Co-authored-by: alflennik [email protected] Co-authored-by: Nick Schonning [email protected] Co-authored-by: Sarah Higley [email protected] Co-authored-by: Jon Gunderson [email protected] Co-authored-by: Andrea N. Cardona [email protected]

View commit edc6ab7b

Read Me First: Remove reference to Internet Explorer in browser support section (pull #2683)

By jugglinmike on June 06, 2023

Per consensus of the 2023-04-25 meeting of the ARIA Authoring Practices Task Force (https://www.w3.org/2023/04/25-aria-apg-minutes.html), remove mention of Internet Explorer from the browser support section.

View commit ca63ddf0

Add AT Support tables for modal dialog, 1 slider, and navigation menu button (pull #2736)

By Matt King on July 24, 2023

Modifies 3 example pages:

  • Add modal dialog support table
  • Add color viewer slider support table
  • Add support table for navigation menu button

View commit 548d8f62

Add guidance for mark role (pull #2753)

By Matt King on August 07, 2023

Updates two practice pages to add information about mark role:

  1. On page "Structural Roles", adds mark role to table in section "All Structural Roles and Their HTML Equivalents".
  2. On page "Providing Accessible Names and Descriptions", adds mark role to table in section"Accessible Name Guidance by Role".

Fixes issue #1821.

View commit cd51ccd8

About Section: Add a page about contributing and APG TF membership (pull #2734)

By Matt King on October 02, 2023

Resolves #2706 by adding a new page providing instructions for contributing to the APG. It describes each of the contribution channels and describes how to utilize each of them.


Co-authored-by: Jon Gunderson [email protected] Co-authored-by: Daniel Montalvo [email protected] Co-authored-by: JaEun Jemma Ku [email protected]

View commit 7fb7c8e2

Landmark Practice: Add note to prevent dialog content wrapped in a landmark (pull #2818)

By Matt King on October 24, 2023

Resolve issue #2512 by adding the following note to principles of landmark design:

Note that wrapping the content of a modal dialog in a landmark region is unnecessary. A landmark that wraps modal content cannot provide any benefit to users because it is not perceivable unless the modal is open. In addition, when a modal is open, a landmark containing its content is superfluous because the modal itself is a container that provides both a name and boundaries.

View commit 9a5e55cc

Menu button pattern and 4 examples: Set aria-expanded to false when menus are closed (pull #2839)

By Andrea N. Cardona on December 17, 2023

Closes issues #697 and #2834 with the following changes:

  • Revise menu button pattern to specify that aria-expanded is set to false when the menu is not displayed.
  • Revise JS and documentation for 3 menu button examples and the toolbar example to set aria-expanded false when their menus are closed.
  • Adjusts corresponding regression tests to ensure the state of expanded is true when the menus are open and false when the menus are closed.

Co-authored-by: Matt King [email protected]

View commit 9be38255

Accessible Names Practice: Recommend association via 'for' attribute when using 'label' element (pull #2882)

By Matt King on December 18, 2023

Resolves issue #2870 by revising the content of the section describing usage of the HTML label element. Revisions include:

  1. Move description of the for attribute technique before the description of the encapsulation technique.
  2. Note that using the for attribute is known as 'explicit association' and using encapsulation is known as 'implicit association'.
  3. State that explicit association has better AT/browser support than implicit association.

Co-authored-by: Patrick H. Lauke [email protected]

View commit 966c4ca8

22 Commits That Fixed Bugs and Editorial Errors in 2023

Button Example Page: Fix CSS that caused focus indicator to disappear (pull #2673)

By Alexander Flenniken on April 12, 2023

Fixes issue #2650: Button example's sample buttons lack visual focus indication.

There was a conflict between the site template and example code. Fixed by:

In patterns/button/examples/css/button.css, Removed: z-index: -1; from button selector.

View commit 34b73c18

Introduction page: Fix typo (change plane to plain (pull #2672)

By Howard Edwards on April 12, 2023

View commit 2cef5f94

Grid Pattern: Fix typos (capitalization) (pull #2701)

By icecream17 on June 05, 2023

  • capitalization consistency: [-c][+C]ontrol + End
  • lowercase Up ("one cell [-U][+u]p" x3)

View commit c0054c2d

Add landmark pattern page (pull #2670)

By Matt King on June 08, 2023

Resolves issue #2645 by adding a new page that describes landmarks as a pattern. The pattern page references the landmarks practice for information about each of the landmark types. Now, readers will find landmark information on both the practices and patterns pages.

View commit fec70323

Hiding Semantics Practice Page: Add missing word "that" (pull #2704)

By Paul BROWN on June 10, 2023

Editorial correction to add a missing word and missing comma.


Co-authored-by: Matt King [email protected]

View commit 08fee221

Removes link to archived ARIA FAQ page (pull #2721)

By Daniel Montalvo on June 10, 2023

View commit b61ac05c

Landmark examples: Update links to related documents and SkipTo script (pull #2624)

By Jon Gunderson on June 10, 2023

Minor editorial and code maintenance changes to all landmark example pages:

  • updated SkipTo script to version 5.2
  • Modify Skipto script tag to use new configuration data parameter
  • updated URL targets in links to two related resources
  • Update copyright date

Co-authored-by: Matt King [email protected]

View commit 4adb78ea

Change Javascript to JavaScript in h2 elements on example pages (pull #2724)

By Matt King on June 19, 2023

Simply fixes a case error where "JavaScript" was written as "Javascript" in an H2 heading on example pages.

View commit 3952625f

Checkbox Example (Mixed-State): Toggle on keyup to prevent continuous toggling (pull #2722)

By Sayan Sivakumaran on June 25, 2023

Modified JavaScript for Checkbox Example (Mixed-State) so that the state of the checkbox does not change until key up. This change prevents continuous toggling if the user holds down the space key.

This is the same change that was made for Checkbox Example (Two State) in pull request #2518.

This commit fully resolves issue #2425.

View commit 049893e2

Combobox Pattern: Simplify wording of description in "About This Pattern" section (pull #2733)

By Matt King on July 10, 2023

On the combobox pattern page, in the "About This Pattern" section, revises the first two paragraphs of the description of a combobox.

View commit e716cc23

Feed Example: Convert images to inline SVG (#2729)

By Paul BROWN on July 24, 2023

Changes the images used for star ratings of restaurants in the feed example to inline SVG. Because the build process that converts to Jekyll for the production site separates images into a separate path, the links to the dynamically loaded image assets were being broken by the build process. With this change, the JavaScript is no longer dependent on paths to image files.

View commit 1d85d95f

4 Example Pages: Reposition AT support tables higher on the page (pull #2737)

By Matt King on July 24, 2023

Moves AT support tables from after the source code sections to before the source code sections.

View commit b3777ac5

Landmark Example Pages: remove background colours that cause color contrast failures (pull #2738)

By James Nurthen on July 24, 2023

View commit 77231653

Switch Example Using HTML Checkbox: Fix editorial error in accessibility features documentation (pull #2750)

By Stephen Page on July 24, 2023

Inaccurate text: When an element loses focus, its border changes from two pixels to two and padding is increased by two pixels.

Corrected text: When an element loses focus, its border changes from two pixels to zero and padding is increased by two pixels.

View commit d6cf9d8d

Select-only Combobox Example: Fix scroll event listener bug (pull #2723)

By Ariella Gilmore on August 07, 2023

Fixes #2719. Scrollbar on the list for select only would close when user would click on it.


Co-authored-by: Andrea N. Cardona [email protected]

View commit 164188c4

Listbox Examples: Update scrolling of listbox item with focus into view when page is magnified (pull #2622)

By Jon Gunderson on September 18, 2023

In the listbox examples, fixes #2545 with the following changes:

  • Updated code to scroll the element referenced by @aria-activedescendant@ into view when view is magnified
  • Updated accessibility features documentation in support of this change.

While fixing this bug, the following additional changes were also made to improve code quality and implement the latest APG code guide practices:

  • Use event.key instead of event.keyCode for identifying keyboard commands.
  • Use class constructors instead of prototype.
  • Changed mousedown event to pointerdown event to support mobile devices.
  • Provide high contrast focus ring around option referenced by aria-activedescendant.
  • Fix bugs in keyboard support for the toolbar
  • Update documentation to improve consistency with current editorial practices

Co-authored-by: Matt King [email protected] Co-authored-by: Mike Pennisi [email protected] Co-authored-by: Aleena [email protected] Co-authored-by: Howard Edwards [email protected]

View commit eed124a7

Treegrid Pattern keyboard section: Correct text for Control + Home/End (pull #2779)

By Andrew Lyons on September 19, 2023

For Control+Home and Control+End, The text in the treegrid pattern differed from the text in the treegrid example. The text in the treegrid pattern didn't make sense because a column only contains one cell so moving focus to the first cell in a column is meaningless. The behaviour and text on the example page are consistent and make logical sense. This commit makes the pattern and example pages consistent with each other.

Inaccurate text: If focus is on a cell, moves focus to the first cell in the column. If focus is on a cell, moves focus to the last cell in the column.

Corrected text: If focus is on a cell, moves focus to the cell in the first row in the same column as the cell that had focus. If focus is on a cell, moves focus to the cell in the last row in the same column as the cell that had focus.

View commit 3b17ee75

Navigation Treeview Example: Correct typo: change 'an' to 'and' in accessibility features (pull #2776)

By Stefan Dietz on September 19, 2023

Incorrect text:

Because transparent borders are visible on some systems with operating system high contrast settings enabled, transparency cannot be used to create a visual difference between the element that is focused an other elements.

Corrected text:

Because transparent borders are visible on some systems with operating system high contrast settings enabled, transparency cannot be used to create a visual difference between the element that is focused and other elements.

View commit 1f2e4620

11 Example pages: Fix typo in accessibility features: change 'an' to 'and' (pull #2803)

By Matt King on September 19, 2023

Replace 'an' with 'and' in the accessibility features description of high contrast support of focus indicator in 11 examples.

Incorrect text:

Because transparent borders are visible on some systems with operating system high contrast settings enabled, transparency cannot be used to create a visual difference between the element that is focused an other elements.

Corrected text:

Because transparent borders are visible on some systems with operating system high contrast settings enabled, transparency cannot be used to create a visual difference between the element that is focused and other elements.

Examples changed:

  • combobox/examples/combobox-autocomplete-both.html
  • combobox/examples/combobox-autocomplete-list.html
  • combobox/examples/combobox-autocomplete-none.html
  • disclosure/examples/disclosure-faq.html
  • disclosure/examples/disclosure-image-description.html
  • menu-button/examples/menu-button-actions-active-descendant.html
  • menu-button/examples/menu-button-actions.html
  • menu-button/examples/menu-button-links.html
  • menubar/examples/menubar-navigation.html
  • switch/examples/switch-checkbox.html
  • switch/examples/switch.html

View commit a92b3809

Developing a Keyboard Interface Practice: Add missing kbd element to macOS re-do command in 'Key Assignment Conventions for Common Functions' (pull #2805)

By David LJ on September 20, 2023

View commit 7b0b4d39

Multiple Combobox Examples: Adjust input height so text is fully visible in Safari on iOS (pull #2780)

By Andrea N. Cardona on October 02, 2023

Resolves #2778 by revising CSS for the following 4 combobox examples so that the space for the input is tall enough to fit the text when viewed in Safari on iOS. Previously, the tops of the letters were chopped off.

  • Editable Combobox With Both List and Inline Autocomplete
  • Editable Combobox With List Autocomplete
  • Editable Combobox without Autocomplete
  • Editable Combobox with Grid Popup

View commit 2b619c14

Modal Dialog Example: Increase z-index of dialog backdrop (#2843)

By Emmanuel Amoah on December 11, 2023

Resolves issue 2842: A CSS bug where part of the modal dialog popup was obscured on some small screens.

View commit d0577918

24 Commits That Made Revisions to APG Back-End Infrastructure

Note: Does not include changes made in the w3c/wai-aria-practices build repo or updates to dependencies made by dependabot.

Infrastructure: Move to Stylelint 15 (#2613)

By Nick Schonning on February 13, 2023

View commit d95c6a41

Infrastructure: Run Prettier on commit of all files (#2614)

By Nick Schonning on February 14, 2023

  • Infrastructure: Run Prettier on commit of all files

  • Update .prettierignore

View commit 0896c7a4

Update lint-staged path to account for restructure (#2616)

By Howard Edwards on February 16, 2023

View commit 95e206fa

Update actions/setup-node@v2 usages to actions/setup-node@v3 (#2603)

By Howard Edwards on February 16, 2023

View commit 70784554

Grid examples and Feed Display: Rename html files to remove camel casing (pull #2597)

By Alexander Flenniken on February 22, 2023

Enable resolution of w3c/wai-aria-practices#186 with the following changes:

  • Rename HTML files of grid examples (e.g. dataGrids.html > data-grids.html)
  • Rename feedDisplay.html to feed-display.html
  • Update hrefs of links to changed file names
  • Update tests to support example file name changes

View commit bfeb2a78

Infrastructure: Update script that provides skipto menu on all pages to version 5.1 (#2619)

By Jon Gunderson on March 07, 2023

  Changes included in SkipTo version 5.1:
  • Supports including headings and landmarks in custom web components.
  • Rewritten to use Javascript modules.
  • Change configuration options to allow customization of container element to be customized; default container is nav element.
  • The APG implementation of SkipTo sets the container to div so it does not create a navigation landmark.

Co-authored-by: Matt King [email protected]

View commit bc49ef94

Infrastructure: Bump ava and selenium-webdriver (pull #2640)

By Howard Edwards on March 07, 2023

  • Bump ava and selenium-webdriver
  • (temporary fix tracked by #2636): Force node-version to 16 for regression.yml

View commit d7482170

Generated by b32cc421cf23b69f6e30c84b244081267833ccb0

By github-actions[bot] on May 15, 2023

View commit ebfd2e9a

Generated by a1a4a8e97403cbb8185804bd6e32155cadc238b5

By github-actions[bot] on May 15, 2023

View commit 90a2b8ff

Infrastructure: Update to version 5.1.6 for JS that provides Skipto menu on all pages (pull #2680)

By Jon Gunderson on June 25, 2023

Updates the script that provides skip link functionality at the top of every page in APG.

View commit b2718f45

Infrastructure: Update vnu-jar parameters to remove unused paths (pull #2617)

By Howard Edwards on June 25, 2023

  • Update the paths used with vnu-jar
  • Update example-usage-warning.html to remove

    tag inside

    tag

View commit 83d13296

chore: sync from w3c/aria-common

By github-actions[bot] on July 05, 2023

Generated by https://github.com/w3c/aria-common/commit/eac5def7a77521dbfb6d85466be6c108085c685f

View commit 114ae455

Infrastructure: Change localhost references to accommodate Node V17 (#2749)

By Howard Edwards on July 25, 2023

Regression tests failed to run with Node V17, so we temporarily pinned the version to 16. This is an alternative fix that enables running with node V17+.

This commit unpins the node version and replaces references to localhost with 127.0.0.1.

Node v17+ deprioritised IPv4 addresses in favour of IPv6 with a change to dns.setDefaultResultOrder. Node made this change without a happy-eyeballs implementation, which meant the loopback address used when running the regression tests resolved to ::1 rather than the IPv4 loopback (127.0.0.1) -- the address geckodriver expected. So this PR now explicitly uses 127.0.0.1. Alternatively, we could have added --dns-result-order=ipv4first to the running script, or added dns.setDefaultResultOrder('ipv4first');, but would eventually remove it as the happy-eyeballs implementation is now included in v20.

View commit 081e8742

Update W3C contact info with Daniel's name

By JaEun Jemma Ku on August 29, 2023

Updated W3C staff contact name and URL

View commit 8f5fd13d

Readme-removing unnecessary comma

By JaEun Jemma Ku on August 29, 2023

View commit 7ec45269

chore: sync from w3c/aria-common

By github-actions[bot] on September 02, 2023

Generated by https://github.com/w3c/aria-common/commit/56a629e259716e64c012a21af97266bc69efa8ce

View commit 4dbed94f

Infrastructure: Update cspell.json with Montalvo (pull #2796)

By Howard Edwards on September 18, 2023

View commit e1c0b968

ReadMe: Remove section about coverage and quality report (#2797)

By Howard Edwards on September 18, 2023

Since the coverage and quality report is now part of the About section within the APG and since it is not directly related to contributing to the APG, removing it from the repository readme.


Co-authored-by: Matt King [email protected]

View commit 69e151a1

Infrastructure: link-checker.js: Check if any of the known pageIds include the hash being checked for (pull #2812)

By Howard Edwards on October 02, 2023

Modifies link checker so that when GitHub dynamically prepends "user-content-" to fragment IDs that are in user-generated content, the link test will pass.

View commit f97050be

Infrastructure: Use aria-practices repo as source for images, patterns.html, and practices.html (pull #2869)

By Alexander Flenniken on December 11, 2023

Resolve issue 2702 by moving HTML content and images from the wai-aria-practices repo into the aria-practices repo. This includes HTML content for the patterns.html page, the practices.html page, and images across all patterns and examples. A complementary change is made to the build process in the wai-aria-practices repo via PR w3c/wai-aria-practices#280.

View commit 4bb1946a

Infrastructure: Source heading for read this first content from aria-practices repo (pull #2867)

By Paul Clue on December 11, 2023

Moves the h2 element that is part of the "Read This First" content from the wai-aria-practices repo into the aria-practices repo. This is part of an effort to ensure all content is sourced and controlled from the aria-practices repo and the wai-aria-practices repo provides only transformations necessary for site build.

View commit 4a3531f0

Infrastructure: Fix inconsistencies in lists of CSS and JS files on 3 example pages (Related to wai-aria-practices issue 255) (pull #2883)

By Alexander Flenniken on December 12, 2023

Each example page has a list of CSS and JS files used by the sourceCode function in shared/js/examples.js. Three examples had errors in this list that are corrected by this commit. This fix supports resolution of w3c/wai-aria-practices#255, which is related to incorrect last revision dates being shown in the footer of example pages.

View commit b2cae7fe

Infrastructure: Fix failing npm run regression-report script (#2291)

By Howard Edwards on December 12, 2023

Changes the regression-report script to support the changes to file system structure made in #2417. Changes include:

  • Support for new content/patterns structure
  • replaced spawnSync with cross-spawn's '.sync'
  • Account for carriage return from Windows when ignoring files
  • Additional path support for Windows
  • Update cspell.json

View commit aa6307a2

chore: sync from w3c/aria-common

By github-actions[bot] on December 13, 2023

Generated by https://github.com/w3c/aria-common/commit/1757c0ea5b934a69ad20ac7f8a487a42f21c4a33

View commit 33b54fc2

Clone this wiki locally