萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 顏色反轉/補色計算:十六進位 RGB 色碼轉換工具函數

應用場景

  • 動態生成對比色文字(淺色背景→深色字,深色背景→淺色字)
  • UI 主題自動生成(按鈕 hover 狀態、焦點狀態)
  • 資料視覺化圖表自動配色
  • 無障礙設計(WCAG 對比度達標)

核心演算法:RGB 通道反相

補色 = 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>";

進階:HSL 空間補色(視覺更自然)

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 提供完整色彩空間轉換、混合、調色板生成功能
copyright © 萬盛學電腦網 all rights reserved