Template:Ensure AA contrast ratio/doc

{{#ifeq:doc |doc

    | 

{{#ifeq:show |show

         | {{#invoke:Message box|mbox}}
        }}{{#if: |
         |   {{#ifexist:Template:Ensure AA contrast ratio
                  | [[Category:{{#switch:Template |Template=Template |Module=Module |User=User |#default=Wikipedia}} documentation pages]]
                  | 
                 }}
        }}
    | 
   }}

{{#invoke:Lua banner|main}}

Usage

This template checks for compliance with WCAG G17, i.e. that a background–foreground colour combination has got a contrast ratio of more than 4.5:1. It takes two arguments, the base colour value, and the tracking category, category, to place non-compliant transclusions in. A third parameter, other, is optional; the template will by default calculate the contrast ratio against black and white, on the assumption that it is used in conjunction with {{#Invoke:Template link general|main|code=on}}.

Note: this is compliant with AAA for 18 point or 14 point bold text.

Contrast ratios

Rating	Normal text	18 point or 14 point bold text
AA	4.5	3
AAA	7	4.5

Examples

• {{#invoke:DemoTemplate|Ensure AA contrast ratio|base=navy|category=Test}}
• {{#invoke:DemoTemplate|Ensure AA contrast ratio|base=navy|other=|category=Test}}
• {{#invoke:DemoTemplate|Ensure AA contrast ratio|base=navy|other=navy|category=Test}}
• {{#invoke:DemoTemplate|Ensure AA contrast ratio|base=red|category=Test}}
• {{#invoke:DemoTemplate|Ensure AA contrast ratio|base=#CC5500|category=Test}}
• {{#invoke:DemoTemplate|Ensure AA contrast ratio|base=asdf|category=Test}}

See also

• {{Ensure AAA contrast ratio}}
• {{Greater color contrast ratio}}
• {{#invoke:Section link|main}}
• {{#invoke:Section link|main}}