Skip to content

Commit

Permalink
Some notification clarifications.
Browse files Browse the repository at this point in the history
Should fix #266
  • Loading branch information
yatil committed Feb 20, 2015
1 parent b7f1064 commit 5c35baa
Showing 1 changed file with 3 additions and 3 deletions.
6 changes: 3 additions & 3 deletions source/forms/notifications.html.erb.md
Expand Up @@ -80,10 +80,10 @@ It is often useful to also use the `<title>` element of the web page to indicate
<%= code_end %>
{:/nomarkdown}

### Using a dialog
### Using dialogs
{:.ex}

A dialog is a moderately prominent way to inform users of changes. It can be used if other means of informing the user prove to be easily missed. Dialogs are more obtrusive and distracting, which may be the desired effect.
A dialog is a common way to inform users of changes. It can be used if other means of informing the user prove to be easily missed. Dialogs are more obtrusive and distracting, which may be the desired effect.

JavaScript provides a very basic alert dialog box that provides proper keyboard navigation and respects the user’s default settings, including font size, colors, and language. A custom dialog implementation would need to match that functionality.

Expand Down Expand Up @@ -135,7 +135,7 @@ When errors occur, it is helpful to list them at the top of the page, before the
- Provide an indication of how to correct mistakes, and remind users of any format requirements;
- Include an in-page link to the corresponding form control to make access easier for the users.

If the user is not redirected to another page, the list of errors should be inserted into a prominent container to inform them. This container should have the role set to alert, to also inform assistive technology users about this change.
Sometimes, for example, when using AJAX techniques, the browser is not loading a new page but shows changes, such as form errors, dynamically on the page. To inform the user in such a case, the list of errors should be inserted into a prominent container on the top. In addition to the advice above, this container should have the `role` attribute set to `alert` to make assistive technology users aware of this change.

{::nomarkdown}
<%= sample_start %>
Expand Down

0 comments on commit 5c35baa

Please sign in to comment.