Skip to content

Commit ce3fac9

Browse files
mcking65mcking65
authored
Appendix: Add change log for APG 1.2 Working Draft 3(pull #1257)
Adds complete change history since the first public working draft of APG 1.1. Includes new change history section for all changes in APG 1.2 that are not in APG 1.1.
1 parent b3ce233 commit ce3fac9

File tree

1 file changed

+267
-4
lines changed

1 file changed

+267
-4
lines changed

‎aria-practices.html

Lines changed: 267 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6662,16 +6662,279 @@ <h2>Indexes</h2>
66626662

66636663
<section id="change_log" class="appendix">
66646664
<h2>Change History</h2>
6665+
6666+
<section id="change_log_2019_november" class="appendix">
6667+
<h3>Changes in November 2019 publication of the 3rd working draft of version 1.2</h3>
6668+
<p>
6669+
APG 1.1 supported ARIA 1.1, and this version, APG 1.2, supports ARIA 1.2.
6670+
The following changes have been made to APG 1.1 in order to make this draft of APG 1.2.
6671+
</p>
6672+
<ul>
6673+
<li>Added section to provide guidance related to 38 document structure roles, 18 of which are new in ARIA 1.2.</li>
6674+
<li>Revised guidance for roles where naming requirements changed in ARIA 1.2. ARIA 1.2 prohibits names on some roles. ARIA 1.2 removed naming requirements from some other roles.</li>
6675+
<li>Added naming guidance for 18 roles that are new in ARIA 1.2.</li>
6676+
<li>Added a button example that illustrates use of the new ARIA 1.2 IDL interface.</li>
6677+
<li>Added a design pattern and example implementation of the new meter role.</li>
6678+
<li>Added a new listbox example that illustrates new ARIA 1.2 support for named groups of options in a listbox.</li>
6679+
<li>Revised the editor menubar example to illustrate new ARIA 1.2 support for named groups of items in a menu.</li>
6680+
<li>Due to change in ARIA 1.2, removed Math role from list of roles that have presentational children.</li>
6681+
<li>In response to feedback, revise description of Escape behavior in the combobox Pattern.</li>
6682+
<li>Corrected color contrast in accordion and date picker examples.</li>
6683+
<li>Fixed 4 bugs in the date picker dialog example.</li>
6684+
<li>Fixed 2 bugs in the spin button date picker example related to incrementing past limits.</li>
6685+
<li>Changed all Examples with buttons to add button type to non-submit buttons.</li>
6686+
<li>Changed tabs examples to hide panels with display: none instead of the hidden attribute.</li>
6687+
</ul>
6688+
<p>For more detail, see:</p>
6689+
<ul>
6690+
<li>
6691+
<a href="https://github.com/w3c/aria-practices/milestone/10">APG 1.2 Working Draft 3 Milestone</a>:
6692+
Github issues closed in the third working draft of APG 1.2 published in November 2019.
6693+
</li>
6694+
<li>
6695+
<a href="https://github.com/w3c/aria-practices/milestone/7">APG 1.2 Working Draft 1 milestone</a>:
6696+
GitHub issues closed in the first working draft of APG 1.2 published on July 17, 2018.
6697+
</li>
6698+
<li><a href="https://github.com/w3c/aria-practices/wiki/Change-Log-for-November-2019-APG-1.2-Working-Draft-3">Detailed change log with links to all commits in the November 2019 publication of APG 1.2 that are not in the August 14, 2019 publication of APG 1.1 release 4.</a></li>
6699+
</ul>
6700+
</section>
6701+
6702+
<section id="change_log_2019_july" class="appendix">
6703+
<h3>Changes in July 2019 Publication of APG 1.1 Release 4</h3>
6704+
<ul>
6705+
<li>Major additions and revisions:
6706+
<ul>
6707+
<li>
6708+
Added section providing guidance on coding and composing accessible names and descriptions.
6709+
This section comprehensively covers ARIA and HTML naming and describing techniques as well as specific guidance for every ARIA role.
6710+
</li>
6711+
<li>Added example of a site navigation bar (<q>menu system</q>) with dropdown lists of links coded using the disclosure pattern.</li>
6712+
<li>
6713+
Added an example of a date picker based on the dialog and grid patterns.
6714+
A modal dialog contains a calendar grid that presents buttons for each day of a month.
6715+
</li>
6716+
<li> Added an example of a date picker that uses three spin buttons for day, month, and year.</li>
6717+
<li>
6718+
Image Carousel Example: Updated the example so that the rotation control is always visible instead of only being visible for keyboard users who move focus into the carousel region.
6719+
Also changed the controls so they are implemented with HTML button elements instead of links with the <code>button</code> role.
6720+
</li>
6721+
<li>Toolbar Example: Added popup text labels for icons that are displayed on both hover and focus.</li>
6722+
</ul>
6723+
</li>
6724+
<li>Minor revisions of guidance or implementation were made to the following design patterns and examples:
6725+
<ul>
6726+
<li>Editor Menubar Example: Updated example so that meta data used by the scripts is specified using <code>data-</code> attributes instead of with <code>rel</code> attributes.</li>
6727+
<li>Radio Group with Active Descendant Example: Removed unused keycodes and fixed linting issues.</li>
6728+
</ul>
6729+
</li>
6730+
</ul>
6731+
<p>Also see:</p>
6732+
<ul>
6733+
<li>
6734+
<a href="https://github.com/w3c/aria-practices/milestone/8">The APG 1.1 Release 4 Milestone</a>:
6735+
which lists the GitHub issues that document discussions and reviews of changes included in the July 2019 publication.
6736+
</li>
6737+
<li>
6738+
<a href="https://github.com/w3c/aria-practices/wiki/Change-Log-for-July-2019-APG-1.1-Note-Release-4">Detailed change log with links to all commits that are new in the July 2019 publication since the January 2019 publication.</a>
6739+
</li>
6740+
</ul>
6741+
</section>
6742+
6743+
<section id="change_log_2019_january" class="appendix">
6744+
<h3>Changes in January 2019 Publication of APG 1.1 Release 3</h3>
6745+
<ul>
6746+
<li>Major additions and revisions:
6747+
<ul>
6748+
<li>Added indexes that allow lookup of examples by role, state, or property.</li>
6749+
<li>Added a carousel design pattern and example implementation.</li>
6750+
<li>Revised radio group pattern to accommodate radio groups nested in toolbars: left and right arrow keys do not change the checked state and can move focus outside the group.</li>
6751+
<li>Redesigned toolbar example to demonstrate an editor toolbar that includes a nested radio group, toggle buttons, menu button, spin button, checkbox, and link. Also fixed several bugs.</li>
6752+
<li>Restructured the accordion example to use HTML heading elements containing HTML button elements.</li>
6753+
<li>Added a regression test framework and suite of regression tests that test all documented keyboard behaviors, roles, states, and properties for each example implementation of a pattern.</li>
6754+
</ul>
6755+
</li>
6756+
<li>Minor revisions of guidance or implementation were made to the following design patterns and examples:
6757+
<ul>
6758+
<li>Alert dialog example: Replaced lorem ipsum placeholder with text that describes actions that trigger the alert dialog and alert message.</li>
6759+
<li>Button Example: Button activation now happens on keyup for space key and aria-hidden was removed from child svg.</li>
6760+
<li>Legacy Combobox examples: Fixed enter key documentation, made Up Arrow set activedescendant to last match in list, corrected up arrow documentation for the textbox.</li>
6761+
<li>Dialog Examples: Fixed IE11 incompatibility in role validity check.</li>
6762+
<li>Single-select listbox example: Fix a bug with aria-selected.</li>
6763+
<li>Grid Examples: Fixed how event listeners were cleaned up.</li>
6764+
<li>Menubar Examples: Applied role="none" where missing from elements in menubar and changed visual design to better distinguish between menuitemradio and meuitemcheckbox elements.</li>
6765+
<li>Radio Group Example: Fixed documentation of elements used in attributes table.</li>
6766+
<li>Spin Button Pattern: Added aria-invalid guidance for values outside allowed range.</li>
6767+
<li>Toolbar Pattern: Clarified keyboard guidance for Tab and Shift+Tab and revised description to remove guidance that conflicted with updated radio group pattern.</li>
6768+
</ul>
6769+
</li>
6770+
</ul>
6771+
<p>Also see:</p>
6772+
<ul>
6773+
<li>
6774+
<a href="https://github.com/w3c/aria-practices/milestone/3?closed=1">The APG 1.1 Release 3 Milestone</a>:
6775+
which lists the GitHub issues that document discussions and reviews of changes included in the January 2019 publication.
6776+
</li>
6777+
<li>
6778+
<a href="https://github.com/w3c/aria-practices/wiki/Change-Log-for-January-2019-APG-1.1-Note-Release-3">Detailed change log with links to all commits that are new in the January 2019 publication since the July 2018 publication.</a>
6779+
</li>
6780+
</ul>
6781+
</section>
6782+
6783+
<section id="change_log_2018_july" class="appendix">
6784+
<h3>Changes in July 2018 Publication of APG 1.1 Release 2</h3>
6785+
<ul>
6786+
<li>
6787+
Added the following:
6788+
<ul>
6789+
<li>Treegrid design pattern and example</li>
6790+
<li>Alert dialog example</li>
6791+
</ul>
6792+
</li>
6793+
<li>Significant revisions of guidance or implementation were made to the following design patterns and examples:
6794+
<ul>
6795+
<li>Accordion pattern and example, including removing two optional key commands from the pattern.</li>
6796+
<li>Checkbox example bug fixes</li>
6797+
<li>ARIA 1.0 Combobox example, including escape key behavior</li>
6798+
<li>ARIA 1.1 Combobox example labeling</li>
6799+
<li>Modal dialog example, primarily code refactoring when adding alert dialog</li>
6800+
<li>Grid pattern, including guidance on column selection</li>
6801+
<li>Listbox examples</li>
6802+
<li>Menu pattern, including guidance on menu/submenu structure</li>
6803+
<li>editor menubar example, including significant improvement to mouse behaviors.</li>
6804+
<li>Menu button example bug fixes</li>
6805+
<li>Navigation menubar example bug fixes</li>
6806+
<li>Radio group example styling</li>
6807+
<li>Tabs pattern, including labeling guidance</li>
6808+
<li>Tree view pattern, including multi-select guidance</li>
6809+
<li>Tree view example bug fixes</li>
6810+
</ul>
6811+
</li>
6812+
</ul>
6813+
<p>Also see:</p>
6814+
<ul>
6815+
<li>
6816+
<a href="https://github.com/w3c/aria-practices/milestone/1?closed=1">The APG 1.1 Release 2 Milestone</a>:
6817+
which lists the GitHub issues that document discussions and reviews of changes included in the July 2018 publication.
6818+
</li>
6819+
<li>
6820+
<a href="https://github.com/w3c/aria-practices/wiki/Change-Log-for-July-2018-APG-1.1-Note-Release-2">Detailed change log with links to all commits that are new in the July 2018 publication since the December 2017 publication of the Note.</a>
6821+
</li>
6822+
</ul>
6823+
</section>
66656824
<section id="change_log_2017_december" class="appendix">
6666-
<h3>Changes from version 1.1</h3>
6667-
<p>Detailed change history will be provided in a subsequent working draft.</p>
6825+
<h3>Changes in December 2017 Publication of APG 1.1 Release 1</h3>
6826+
<ul>
6827+
<li>
6828+
Added the following:
6829+
<ul>
6830+
<li>Read Me First section</li>
6831+
<li>Combobox pattern</li>
6832+
<li>Combobox examples: 3 ARIA 1.0 style and 4 ARIA 1.1 style</li>
6833+
<li>Disclosure pattern</li>
6834+
<li>Feed example display page</li>
6835+
<li>Grid and table properties guidance section</li>
6836+
<li>Collapsible dropdown listbox example</li>
6837+
<li>Multi-thumb slider examples</li>
6838+
<li>Table pattern and example</li>
6839+
</ul>
6840+
</li>
6841+
<li>The top of each example page now includes a set of four related links to:
6842+
<ul>
6843+
<li><Q>Browser and Assistive Technology Support</Q> section of <q>Read Me First</q></li>
6844+
<li><q>Report Issue</q> page in the Github repository</li>
6845+
<li><q>Related Issues</q> listed in the Github project for the example</li>
6846+
<li><q>Design Pattern</q> section that applies to the example</li>
6847+
</ul>
6848+
</li>
6849+
<li>All Javascript and CSS files used by the examples include the correct license and copyright statements.</li>
6850+
<li>Significant revisions of guidance and implementation were made to the following sections, design patterns, and examples:
6851+
<ul>
6852+
<li>Introduction</li>
6853+
<li>Keyboard guidance for Mac OS</li>
6854+
<li>Accordion example</li>
6855+
<li>Mixed checkbox examples</li>
6856+
<li>Scrollable layout grid example</li>
6857+
<li>Listbox examples</li>
6858+
<li>Modal dialog example</li>
6859+
<li>editor menubar example</li>
6860+
<li>Navigation menubar example</li>
6861+
<li>Menu button examples</li>
6862+
<li>Spinbutton pattern</li>
6863+
<li>Toolbar example</li>
6864+
<li>Tree view examples</li>
6865+
</ul>
6866+
</li>
6867+
</ul>
66686868
<p>Also see:</p>
66696869
<ul>
66706870
<li>
6671-
<a href="https://github.com/w3c/aria-practices/milestone/7">1.2 APG Working Draft 1 milestone,</a>
6871+
<a href="https://github.com/w3c/aria-practices/milestone/6">1.1 APG Release 1 milestone,</a>
66726872
which lists the GitHub issues that document discussions and reviews of changes included in the December 2017 publication.
66736873
</li>
6674-
<li>Link to a github wiki page of commit history goes here.</li>
6874+
<li>
6875+
<a href="https://github.com/w3c/aria-practices/wiki/Change-Log-for-December-2017-Note-Release-1">Detailed change log with links to all commits that are new in the December 2017 publication as a Note since the June 2017 working draft.</a>
6876+
</li>
6877+
</ul>
6878+
</section>
6879+
<section id="change_log_2017_june" class="appendix">
6880+
<h3>Changes in June 2017 APG 1.1 Working Draft</h3>
6881+
<ul>
6882+
<li>
6883+
Added the following:
6884+
<ul>
6885+
<li>Modal dialog example</li>
6886+
<li>Disclosure design pattern</li>
6887+
<li>Example disclosure for FAQ</li>
6888+
<li>Example disclosure for image description</li>
6889+
<li>Draft of feed pattern</li>
6890+
<li>Example feed implementation</li>
6891+
<li>Example of menu button using aria-activedescendant</li>
6892+
<li>Example of tabs with manual activation</li>
6893+
</ul>
6894+
</li>
6895+
<li>Design pattern section: moved examples subsection of each design pattern to be
6896+
the first subsection.</li>
6897+
<li>
6898+
Across all example pages:
6899+
<ul>
6900+
<li>Improved visual design of tables that document keyboard implementation,
6901+
roles, states, and properties.</li>
6902+
<li>Improved consistency of editorial style.</li>
6903+
</ul>
6904+
</li>
6905+
<li>
6906+
Significant revisions of guidance and implementation were made to the following design
6907+
patterns and example pages:
6908+
<ul>
6909+
<li>Accordion example</li>
6910+
<li>Alert example</li>
6911+
<li>Breadcrumb example</li>
6912+
<li>Button example</li>
6913+
<li>Checkbox examples</li>
6914+
<li>Dialog (modal) design pattern</li>
6915+
<li>Grid examples</li>
6916+
<li>Landmark examples</li>
6917+
<li>Link example</li>
6918+
<li>Listbox example</li>
6919+
<li>Menubar examples</li>
6920+
<li>Menu button examples</li>
6921+
<li>Radio group example</li>
6922+
<li>Slider design pattern</li>
6923+
<li>Slider example</li>
6924+
<li>Example of tabs with automatic activation</li>
6925+
<li>Tree view examples</li>
6926+
</ul>
6927+
</li>
6928+
</ul>
6929+
<p>Also see:</p>
6930+
<ul>
6931+
<li>
6932+
<a href="https://github.com/w3c/aria-practices/issues?q=is%3Aclosed+is%3Aissue+milestone%3A%22Jan+2017+Clean+Up%22+sort%3Aupdated-asc">January 2017 Clean Up Milestone</a>,
6933+
which lists the GitHub issues that document discussions and reviews of changes included in the June 2017 working draft.
6934+
</li>
6935+
<li>
6936+
<a href="https://github.com/w3c/aria-practices/wiki/Change-Log-for-June-2017-Working-Draft">Detailed change log with links to all commits that are new in the June 2017 working draft.</a>
6937+
</li>
66756938
</ul>
66766939
</section>
66776940
</section>

0 commit comments

Comments
 (0)