Difference between revisions of "Template:Ensure AA contrast ratio/doc"

From blackwiki
Jump to navigation Jump to search
imported>Rich Farmbrough
imported>Vanisaac
m (→‎See also: clean up per WP:CAT#T and WP:AWBREQ add template:Sandbox other)
 
(3 intermediate revisions by one other user not shown)
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
 
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
 
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
 +
{{Lua|Module:Color contrast}}
 +
 
==Usage==
 
==Usage==
 
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 4.5: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 {{Tlx|Greater color contrast ratio}}.
 
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 4.5: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 {{Tlx|Greater color contrast ratio}}.
Line 15: Line 17:
 
| AAA || 7 || '''4.5'''
 
| AAA || 7 || '''4.5'''
 
|}
 
|}
 
==See also==
 
* {{Tlx|Ensure AAA contrast ratio}}
 
  
 
==Examples==
 
==Examples==
Line 27: Line 26:
 
* {{#invoke:DemoTemplate|{{BASEPAGENAME}}|base=asdf|category=Test}}
 
* {{#invoke:DemoTemplate|{{BASEPAGENAME}}|base=asdf|category=Test}}
  
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |
+
==See also==
 +
* {{tl|Ensure AAA contrast ratio}}
 +
* {{tl|Greater color contrast ratio}}
 +
* {{section link|Template:Color contrast conformance|HTML colors}}
 +
* {{section link|Wikipedia:Manual of Style/Accessibility|Color}}
 +
 
 +
<includeonly>{{Sandbox other||
 
<!-- Categories below this line, please; interwikis at Wikidata -->
 
<!-- Categories below this line, please; interwikis at Wikidata -->
 
[[Category:Color conversion templates]]
 
[[Category:Color conversion templates]]
 
}}</includeonly>
 
}}</includeonly>

Latest revision as of 01:30, 25 April 2020

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 {{Greater color contrast ratio}}.

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

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

See also