Difference between revisions of "Template:Ensure AAA contrast ratio"

From blackwiki
Jump to navigation Jump to search
imported>The Earwig
m (Protected "Template:Ensure AAA contrast ratio": Highly visible template: nearly 15,000 mainspace transclusions ([Edit=Allow only template editors and admins] (indefinite) [Move=Allow only template editors and admins] (ind...)
imported>The Earwig
(moving documentation to unprotected subpage)
 
Line 1: Line 1:
 
<includeonly>{{#if:{{{base|}}}|{{#ifexpr:{{#invoke:Color contrast|ratio|{{{base}}}|{{{other|}}}|error=21}} < 7 OR {{#invoke:Color contrast|ratio|{{{base}}}|black|error=0}} < 7 AND {{#invoke:Color contrast|ratio|{{{base}}}|white|error=0}} < 7|{{{category|}}}}}}}</includeonly><noinclude>
 
<includeonly>{{#if:{{{base|}}}|{{#ifexpr:{{#invoke:Color contrast|ratio|{{{base}}}|{{{other|}}}|error=21}} < 7 OR {{#invoke:Color contrast|ratio|{{{base}}}|black|error=0}} < 7 AND {{#invoke:Color contrast|ratio|{{{base}}}|white|error=0}} < 7|{{{category|}}}}}}}</includeonly><noinclude>
{{Documentation|content=
+
{{Documentation}}</noinclude>
This template checks for compliance with [http://www.w3.org/TR/2014/NOTE-WCAG20-TECHS-20140916/G17 WCAG G17], i.e. that a background–foreground colour combination has got a contrast ratio of more than 7:1. It takes two arguments, the <code>base</code> colour value, and the tracking category, <code>category</code>, to place non-compliant transclusions in. A third parameter, <code>other</code>, 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 {{tl|Greater color contrast ratio}}.
 
 
 
== Examples ==
 
* {{#invoke:DemoTemplate|{{PAGENAME}}|base=navy|category=Test}}
 
* {{#invoke:DemoTemplate|{{PAGENAME}}|base=navy|other=|category=Test}}
 
* {{#invoke:DemoTemplate|{{PAGENAME}}|base=navy|other=navy|category=Test}}
 
* {{#invoke:DemoTemplate|{{PAGENAME}}|base=red|category=Test}}
 
* {{#invoke:DemoTemplate|{{PAGENAME}}|base=#CC5500|category=Test}}
 
* {{#invoke:DemoTemplate|{{PAGENAME}}|base=asdf|category=Test}}
 
 
 
==See also==
 
*  {{Tlx|Ensure AA contrast ratio}}
 
 
 
}}
 
[[Category:Color conversion templates]]</noinclude>
 

Latest revision as of 07:41, 14 December 2015

Template documentation[view] [edit] [history] [purge]

This template checks for compliance with WCAG G17, i.e. that a background–foreground colour combination has got a contrast ratio of more than 7: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 {{Greater color contrast ratio}}.

Examples

  • {{Ensure AAA contrast ratio|base=navy|category=Test}}
  • {{Ensure AAA contrast ratio|other=|base=navy|category=Test}}
  • {{Ensure AAA contrast ratio|other=navy|base=navy|category=Test}} → Test
  • {{Ensure AAA contrast ratio|base=red|category=Test}} → Test
  • {{Ensure AAA contrast ratio|base=#CC5500|category=Test}} → Test
  • {{Ensure AAA contrast ratio|base=asdf|category=Test}} → Test

Templates implementing Ensure AAA contrast ratio

Templates and the associated tracking categories, as of June 2019:

See also