模組:Color contrast/doc

此模块主要用于以下模版：

{{Color contrast ratio}}

{{ColorToLum}} / {{RGBColorToLum}}

{{Color contrast conformance}}

{{Ensure AAA contrast ratio}}

{{Ensure AA contrast ratio}}

{{Greater color contrast ratio}}

此模版也用于以下模块：

Module:Navbox

Module:Userbox

Module:Episode list

并且用于以下模块的说明文档页面：

Module:College color

函數說明

• sRGB(v)：從sRGB色彩空间的非線性轉換：此函數所用到的常數則是使用<math>\left(\frac{K_0+a}{1+a}\right)^\gamma=\frac{K_0}{\phi}</math>與<math>\gamma\left(\frac{K_0+a}{1+a}\right)^{\gamma-1}\left(\frac{1}{1+a}\right)=\frac{1}{\phi}</math>這2個方程式代入<math>a=0.055</math>、<math>\gamma=2.4</math>得到<math>\phi=12.92</math>與<math>K_0=0.03928</math>
• rgbdec2lum(R,G,B)：從三原色光模式轉成CIE XYZ的Y值
• hsl2lum(h,s,l)：從HSL色彩空间轉成CIE XYZ的Y值，其中h所用的單位為度
• color2lum(c)：從HTML顏色轉成CIE XYZ的Y值

用法

要使用此模块，您可以使用上面列出的模板之一或直接调用该模块。

计算相对发光的步骤

{{ColorToLum|color}} or {{#invoke:Color contrast|lum|color}}

计算两种颜色之间的对比度的步骤

{{Color contrast ratio|color1|color2|error=?}} or {{#invoke:Color contrast|ratio|color1|color2|error=?}}

确定两种颜色(Color2a和Color2b)中哪种颜色与特定颜色(Color1)的对比度较大

{{Greater color contrast ratio|color1|color2a|color2b}} or {{#invoke:Color contrast|greatercontrast|color1|color2a|color2b}}

计算在CSS样式字符串中指定的背景颜色和文本颜色之间的对比度

{{#invoke:Color contrast|styleratio|css style statement string|default background color|default text color}}