Modul:Color contrast/doc

Modul Lua ini digunakan di anggaran 326,000 laman. Untuk mengelakkan gangguan besar-besaran dan muatan pelayan, apa-apa perubahan hendaklah diuji di sublaman modul (kotak pasir atau kes ujian), atau di kotak pasir modul anda sendiri. Perubahan yang sudah diuji boleh ditambah pada laman ini dalam suntingan tunggal. Pertimbangkan untuk membincangkan perubahan di laman perbincangan sebelum menerapkannya.

Modul ini bergantung pada modul-modul lain: Module:Color contrast/colors

This module is used primarily by

• {{Color contrast ratio}}
• {{RGBColorToLum}}
• {{Color contrast conformance}}
• {{Ensure AAA contrast ratio}}
• {{Ensure AA contrast ratio}}
• {{Greater color contrast ratio}}

It is also used for tracking within

• Module:Navbox
• Module:Userbox
• Module:Episode list

and for documentation in

• Module:College color

The formulas used are stated in WCAG 2.x specifications. WCAG is the main guideline for creating accessible interfaces on the web.

To use this module, you may use one of the above listed templates or invoke the module directly

• To compute relative luminescence:
  {{RGBColorToLum|color}} or {{#invoke:Color contrast|lum|color}}
• To compute a contrast ratio between two colors:
  {{Color contrast ratio|color1|color2|error=?}} or {{#invoke:Color contrast|ratio|color1|color2|error=?}}
• To determine which of two colors (color2a and color2b) has the greater contrast ratio with a particular color (color1):
  {{Greater color contrast ratio|color1|color2a|color2b}} or {{#invoke:Color contrast|greatercontrast|color1|color2a|color2b}}
• To compute the contrast ratio between the background and text colors specified in a css style string:
  {{#invoke:Color contrast|styleratio|css style statement string|default background color|default text color}}