補色 = 255 - 原色值(每個 R/G/B 通道獨立計算)
原色:#0000FF (藍) → R=0, G=0, B=255
補色:#FFFF00 (黃) → R=255, G=255, B=0
<?php
/**
* 計算顏色補色(反色)
* @param string $hexColor 十六進位色碼(#RRGGBB 或 #RGB)
* @param bool $includeHash 返回值是否包含 # 前綴
* @return string 補色色碼
*/
function colorInvert($hexColor, $includeHash = true) {
// 移除 # 並標準化為 6 位
$hex = ltrim($hexColor, '#');
// 支援 3 位縮寫(#F00 → #FF0000)
if (strlen($hex) === 3) {
$hex = $hex[0].$hex[0] . $hex[1].$hex[1] . $hex[2].$hex[2];
}
if (strlen($hex) !== 6 || !ctype_xdigit($hex)) {
throw new InvalidArgumentException("Invalid hex color: $hexColor");
}
$rgb = [];
for ($i = 0; $i < 3; $i++) {
$val = hexdec(substr($hex, $i * 2, 2));
$inv = 255 - $val;
$rgb[] = str_pad(dechex($inv), 2, '0', STR_PAD_LEFT);
}
return ($includeHash ? '#' : '') . implode('', $rgb);
}
/**
* 計算相對亮度(用於決定黑/白文字)
* WCAG 2.1 相對亮度公式
*/
function getRelativeLuminance($hexColor) {
$hex = ltrim($hexColor, '#');
if (strlen($hex) === 3) {
$hex = $hex[0].$hex[0] . $hex[1].$hex[1] . $hex[2].$hex[2];
}
$rgb = [];
for ($i = 0; $i < 3; $i++) {
$val = hexdec(substr($hex, $i * 2, 2)) / 255;
$rgb[] = $val <= 0.03928 ? $val / 12.92 : pow(($val + 0.055) / 1.055, 2.4);
}
return 0.2126 * $rgb[0] + 0.7152 * $rgb[1] + 0.0722 * $rgb[2];
}
/**
* 根據背景色自動決定文字顏色(黑/白)
*/
function getContrastTextColor($bgColor) {
$luminance = getRelativeLuminance($bgColor);
return $luminance > 0.179 ? '#000000' : '#FFFFFF'; // 閾值可調
}
// 使用範例
$colors = ['#000000', '#FFFFFF', '#FF0000', '#00FF00', '#0000FF', '#FFFF00', '#3498db', '#e74c3c'];
echo "<table border=1 cellpadding=5><tr><th>原色</th><th>補色</th><th>建議文字色</th></tr>";
foreach ($colors as $c) {
$inv = colorInvert($c);
$text = getContrastTextColor($c);
echo "<tr><td style='background:$c; color:$text'>$c</td>"
. "<td style='background:$inv; color:" . getContrastTextColor($inv) . "'>$inv</td>"
. "<td style='background:$c; color:$text'>$text</td></tr>";
}
echo "</table>";
RGB 空間補色有時視覺不自然(如藍→黃過渡刺眼)。HSL 空間旋轉 180° 得到的補色更符合人眼感知。
function hexToHsl($hex) {
$hex = ltrim($hex, '#');
if (strlen($hex) === 3) $hex = $hex[0].$hex[0].$hex[1].$hex[1].$hex[2].$hex[2];
$r = hexdec(substr($hex,0,2)) / 255;
$g = hexdec(substr($hex,2,2)) / 255;
$b = hexdec(substr($hex,4,2)) / 255;
$max = max($r,$g,$b); $min = min($r,$g,$b);
$l = ($max + $min) / 2;
if ($max === $min) {
$h = $s = 0;
} else {
$d = $max - $min;
$s = $l > 0.5 ? $d / (2 - $max - $min) : $d / ($max + $min);
switch($max) {
case $r: $h = ($g - $b) / $d + ($g < $b ? 6 : 0); break;
case $g: $h = ($b - $r) / $d + 2; break;
case $b: $h = ($r - $g) / $d + 4; break;
}
$h /= 6;
}
return ['h'=>$h*360, 's'=>$s*100, 'l'=>$l*100];
}
function hslToHex($h, $s, $l) {
$h /= 360; $s /= 100; $l /= 100;
$c = (1 - abs(2*$l - 1)) * $s;
$x = $c * (1 - abs(fmod($h*6, 2) - 1));
$m = $l - $c/2;
if ($h < 1/6) [$r,$g,$b] = [$c,$x,0];
elseif ($h < 2/6) [$r,$g,$b] = [$x,$c,0];
elseif ($h < 3/6) [$r,$g,$b] = [0,$c,$x];
elseif ($h < 4/6) [$r,$g,$b] = [0,$x,$c];
elseif ($h < 5/6) [$r,$g,$b] = [$x,0,$c];
else [$r,$g,$b] = [$c,0,$x];
$toHex = fn($v) => str_pad(dechex(round(($v+$m)*255)), 2, '0', STR_PAD_LEFT);
return '#' . $toHex($r) . $toHex($g) . $toHex($b);
}
function colorInvertHsl($hex) {
$hsl = hexToHsl($hex);
$hsl['h'] = fmod($hsl['h'] + 180, 360); // 色相旋轉 180°
// 可選:亮度也反轉 $hsl['l'] = 100 - $hsl['l'];
return hslToHex($hsl['h'], $hsl['s'], $hsl['l']);
}
// 對比
echo "RGB補色: " . colorInvert('#3498db') . "\n"; // #cb6724 (橙褐)
echo "HSL補色: " . colorInvertHsl('#3498db') . "\n"; // #db5834 (紅橙,更自然)
<?php
function generateButtonCss($bgColor) {
$textColor = getContrastTextColor($bgColor);
$hoverBg = colorInvertHsl($bgColor); // 或調整亮度:lighten/darken
$focusRing = colorInvert($bgColor);
return "
.btn-custom {
background: $bgColor;
color: $textColor;
border: none;
padding: 0.5rem 1rem;
border-radius: 4px;
transition: background 0.2s;
}
.btn-custom:hover { background: $hoverBg; }
.btn-custom:focus { box-shadow: 0 0 0 3px $focusRing; }
";
}
echo generateButtonCss('#3498db');
colorInvert() RGB 通道 255-val,適用程式化生成colorInvertHsl() 色相旋轉 180°,適合設計系統getContrastTextColor() 基於 WCAG 相對亮度,保證可讀性league/color、kornrunner/color 提供完整色彩空間轉換、混合、調色板生成功能