模組:Color contrast/doc

此頁面為 Module:Color contrast 的說明文件

此模塊主要用於以下模版:

{{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色彩空間的非線性轉換:此函數所用到的常數則是使用  這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}}