cnumr/EcoIndex

Improve error handling

yaaax opened this issue · 0 comments

yaaax commented

See https://govuk-elements.herokuapp.com/errors/example-form-validation-single-question-text

When an error occurs:

  • prefix the <title> with "Error: "
  • show an error summary at the top of the page
  • move keyboard focus to the start of the summary
    to move keyboard focus, put tabindex="-1" on the containing div and use obj.focus()
  • ensure that the summary is announced to as many screen readers as possible
    use role="alert" on the containing div
  • use a heading at the top of the summary
  • associate the heading with the summary box
    use the ARIA attribute aria-labelledby on the containing div, so that screen readers will automatically announce the heading as soon as focus is moved to the div
  • link from the error list in the summary to the fields with errors
  • add a 5px red left border to the field with the error
  • show a red and bold error message between each question and field with an error
  • associate each error message with the corresponding field by adding it to the label (or legend)

Also consider using the aria-invalid attribute to programmatically indicate that a field has an error. The value of the aria-invalid attribute will vary depending on the type of error.