Tutorials/Forms/Changes/2015-01-31

This is an overview of the changes that were made to the forms tutorial in January 2015, based on the comments of WCAG WG and EOWG. More detailed changes are recorded on GitHub.

Overall Changes

• The Tips & Tricks page was deleted as the content did fit well on other pages.

Forms Concepts (minor changes)

Sources:

• Current version
• New Version

Changes Source Diff, HTML Diff

• Editorial Edits:
  • Moved a sentence about how simple forms improve the user experience from Tips & Tricks page.
  • Moved a section about time limits from Tips & Tricks.
  • Made minor wording changes.

Labeling Controls (major changes)

Sources:

• Current version
• New Version

Changes Source Diff, HTML Diff

• Technical Changes:
  • Changed order of the sections: The explicit way to associate label text to form controls is now listed first. Additionally the section on title was moved to the “Hiding label text” section.

• Editorial Changes:
  • Page has been entirely rearranged, so the wording has been changed and sections rewritten to help users to understand the page easier.

Grouping Controls (major changes)

Sources:

• Current version
• New Version

Changes Source Diff, HTML Diff

• Technical Edits:
  • Added fieldset example for billing/shipping address (to have a compelling example to use with WAI-ARIA).
  • Added WAI-ARIA example for billing/shipping address.
  • Added optgroup example (moved from Tips & Tricks).

• Editorial Changes:
  • Changed introduction to mention optgroup as well.
  • Added some text to augment added sections above.

Form Instructions (medium changes)

Sources:

• Current version
• New Version

Changes Source Diff, HTML Diff

• Technical Changes:
  • Removed the section “informing users” as it did not represent best practice.
  • Added a section about aria-labelledby and aria-describedby.

• Editorial Edits:
  • Minor changes, some new text with new sections.

Validating Input (minor changes)

Sources:

• Current version
• New Version

Changes Source Diff, HTML Diff

• Editorial Edits:
  • Added mention of custom validation.
  • Added mention of accessible notifications.
  • Added some clarifications on the need for server-side validation.
  • Moved a sentence on liberal content input from the Tips and Tricks page to the “be forgiving of different input formats” section.

User Notifications (medium changes)

Sources:

• Current version
• New Version

Changes Source Diff, HTML Diff

• Technical Changes:
  • Simplified the dialog part of the page to make it easier to understand, which includes removing the “temporary pop-up” section.

• Editorial Edits:
  • Changed pop-up dialog section to make more sense simplified.

Multi-Page Forms (minor changes)

Sources:

• Current version
• New Version

Changes Source Diff, HTML Diff

• Technical Changes:
  • Prevented the progress element from animating (on certain systems).

• Editorial Edits:
  • Added description on how to prevent the progress element from animating (on certain systems).

Custom Controls (almost no changes)

Sources:

• Current version
• New Version

Changes Source Diff, HTML Diff

• Technical Changes:
  • Changed the color of the stars to have a bit more contrast.

• Editorial Edits:
  • None.

Tips and Tricks (deleted)

This page has been deleted, the content has been put on other pages.