此頁面為 Module:Color contrast 的說明文件
此模組文件依賴以下Lua模塊:
此模塊主要用於以下模版:
- {{Color contrast ratio}}
- {{ColorToLum}} / {{RGBColorToLum}}
- {{Color contrast conformance}}
- {{Ensure AAA contrast ratio}}
- {{Ensure AA contrast ratio}}
- {{Greater color contrast ratio}}
此模版也用於以下模塊:
並且用於以下模塊的說明文檔頁面:
函數說明
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值
用法
To use this module, you may use one of the above listed templates or invoke the module directly
To compute relative luminescence
{{ColorToLum|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}}