Sustainable development and the OAG

Resources

Reports to Northern Legislative Assemblies

Our culture

Office of the Auditor General of Canada Code of Values, Ethics, and Professional Conduct

Publications

Office of the Auditor General of Canada

About the OAG

Reports to Crown Corporations

Who We Are

Form controls must appear sufficiently distinct from their surroundings, so that people 
with visual impairments are still able to clearly see them.    

Either the border or the form control itself must have a 3:1 colour contrast with the 
surrounding area. 

## Methodology

* All `<input>`, `<textarea>`, and `<select>` elements are checked.
* For `<input>` elements, these types are ignored as their
  appearance is controlled by the browser or operating system:
  `checkbox`, `radio`, `submit`, `reset`, `image`, `hidden`, `file`. 
* The flattened background color of the control is determined. This is the color of the
  control itself, combined with any parent elements if the control is transparent.
* If the control has a border or outline:
  * The flattened background color of each edge is determined. 
    This is the color of the edge itself, combined with any parent elements
    if the edge is transparent.
  * If any edge has sufficient contrast with the flattened background color of the control, 
    the control is considered to have sufficient contrast.
* If the control does not have a border or outline:
  * The flattened background color of the surrounding 
    area is determined. This is the color of the first control's parent element which is at least 
    one pixel larger around the element in every dimension, i.e. above, below, left, and right.
  * If the background color of the element has sufficient contrast with surrounding area color
    the control is considered to have sufficient contrast.

## Troubleshooting

There are some limitations to the contrast checker:

* The use of drop shadows, glowing effects, gradients, and other complex effects 
  mean there is no one clear color to determine the contrast ratio against. 
  In these cases, the contrast ratio cannot currently be determined.
* It is possible for an element to be positioned over multiple elements, e.g. via
  `position: absolute` or `position: fixed`. In this case, the contrast ratio cannot 
  currently be determined.

## Further reading

* [WCAG 1.4.11](https://www.w3.org/WAI/WCAG21/Understanding/non-text-contrast.html)

non-text-contrast

June 2024

May 2024

Auditor General of Canada

Title / URL	Issues
Sustainable development and the OAGwww.oag-bvg.gc.ca/internet/English/sds_fs_e_920.html	1
Resourceswww.oag-bvg.gc.ca/internet/English/au_fs_e_44184.html	1
Reports to Northern Legislative Assemblieswww.oag-bvg.gc.ca/internet/English/nla_fs_e_857.html	1
Our culturewww.oag-bvg.gc.ca/internet/English/au_fs_e_43560.html	1
Office of the Auditor General of Canada Code of Values, Ethics, and Professional Conductwww.oag-bvg.gc.ca/internet/English/au_fs_e_8603.html	1
Publicationswww.oag-bvg.gc.ca/internet/English/rp_fs_e_44.html	1
Office of the Auditor General of Canadawww.oag-bvg.gc.ca/internet/English/admin_e_41.html	1
About the OAGwww.oag-bvg.gc.ca/internet/English/au_fs_e_43.html	1
Reports to Crown Corporationswww.oag-bvg.gc.ca/internet/English/au_fs_e_39466.html	1
Who We Arewww.oag-bvg.gc.ca/internet/English/au_fs_e_370.html	1

Ensure form controls contrast sufficiently with their surroundings

Auditor General of Canada

Where this issue has occurred