模块:Color contrast/doc
这是Module:Color contrast的文档页面
![]() | 此模块已于36112个页面中应用,对其进行的修改会影响到这些页面。请先在本模块的沙盒或测试样例子页面或您的用户子页面中测试所要进行的修改,并请考虑在应用修改前,于讨论页上进行讨论。 |
![]() | 此模块已被保护。此为高度可见模块,其已用于大量条目或被频繁替换引用。由于破坏或失误会影响诸多页面,即便细小的改动也可能导致大量服务器负载,因此已被保护,不可编辑。 |
![]() | 使用Lua语言编写: |
此模块主要用于以下模版:
- {{Color contrast ratio}}
- {{ColorToLum}} / {{RGBColorToLum}}
- {{Color contrast conformance}}
- {{Ensure AAA contrast ratio}}
- {{Ensure AA contrast ratio}}
- {{Greater color contrast ratio}}
此模版也用于以下模块:
并且用于以下模块的说明文档页面:
函数说明
[编辑]sRGB(v)
:从sRGB色彩空间的非线性转换:此函数所用到的常数则是使用与这2个方程式代入、得到与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}}