前端開發頻繁需在 CSS 顏色格式間轉換:設計師給 HEX,Canvas 需 RGB,動畫插值用 HSL,透明度要 RGBA/HSLA。本文提供一個零依賴、Tree-shaking 友善、TypeScript 就緒的完整轉換庫,涵蓋所有主流格式雙向轉換、驗證、解析、字串化。
/** 統一內部表示:0-255 整數 + 0-1 alpha */
class Color {
constructor(r, g, b, a = 1) {
this.r = Math.round(Math.max(0, Math.min(255, r)));
this.g = Math.round(Math.max(0, Math.min(255, g)));
this.b = Math.round(Math.max(0, Math.min(255, b)));
this.a = Math.max(0, Math.min(1, a));
}
// 靜態工廠方法
static fromRGB(r, g, b) { return new Color(r, g, b); }
static fromRGBA(r, g, b, a) { return new Color(r, g, b, a); }
static fromHex(hex) { return Color.parse(hex); }
static fromHSL(h, s, l) { return Color.fromHSLA(h, s, l, 1); }
static fromHSLA(h, s, l, a) { return new Color(...hslToRgb(h, s, l), a); }
static parse(str) { return ColorParser.parse(str); }
}
// HSL (0-360, 0-1, 0-1) -> RGB (0-255)
function hslToRgb(h, s, l) {
h = (h % 360 + 360) % 360 / 360; // 歸一化 0-1
const hue2rgb = (p, q, t) => {
if (t < 0) t += 1;
if (t > 1) t -= 1;
if (t < 1/6) return p + (q - p) * 6 * t;
if (t < 1/2) return q;
if (t < 2/3) return p + (q - p) * (2/3 - t) * 6;
return p;
};
let r, g, b;
if (s === 0) { r = g = b = l; }
else {
const q = l < 0.5 ? l * (1 + s) : l + s - l * s;
const p = 2 * l - q;
r = hue2rgb(p, q, h + 1/3);
g = hue2rgb(p, q, h);
b = hue2rgb(p, q, h - 1/3);
}
return [Math.round(r * 255), Math.round(g * 255), Math.round(b * 255)];
}
// RGB -> HSL
function rgbToHsl(r, g, b) {
r /= 255; g /= 255; b /= 255;
const max = Math.max(r, g, b), min = Math.min(r, g, b);
let h, s, l = (max + min) / 2;
if (max === min) { h = s = 0; }
else {
const 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 [Math.round(h * 360), Math.round(s * 100), Math.round(l * 100)];
}
// HEX 解析(支援 #rgb, #rgba, #rrggbb, #rrggbbaa)
const HEX_REGEX = /^#?([a-f\d]{3,4}|[a-f\d]{6}|[a-f\d]{8})$/i;
function parseHex(hex) {
const m = hex.match(HEX_REGEX);
if (!m) throw new Error(`Invalid HEX: ${hex}`);
let h = m[1];
if (h.length === 3 || h.length === 4) {
h = h.split('').map(c => c + c).join(''); // 展開 #rgb -> #rrggbb
}
const r = parseInt(h.slice(0, 2), 16);
const g = parseInt(h.slice(2, 4), 16);
const b = parseInt(h.slice(4, 6), 16);
const a = h.length === 8 ? parseInt(h.slice(6, 8), 16) / 255 : 1;
return new Color(r, g, b, a);
}
class ColorParser {
static parse(str) {
if (!str || typeof str !== 'string') throw new Error('Invalid color string');
const s = str.trim().toLowerCase();
// named colors (可選擇內建基本 148 色表)
if (NAMED_COLORS[s]) return Color.fromHex(NAMED_COLORS[s]);
// hex
if (HEX_REGEX.test(s)) return parseHex(s);
// rgb/rgba
const rgbMatch = s.match(/^rgba?\((.+)\)$/);
if (rgbMatch) {
const parts = rgbMatch[1].split(',').map(p => p.trim());
const r = parseFloat(parts[0]);
const g = parseFloat(parts[1]);
const b = parseFloat(parts[2]);
const a = parts[3] !== undefined ? parseFloat(parts[3]) : 1;
return new Color(r, g, b, a);
}
// hsl/hsla
const hslMatch = s.match(/^hsla?\((.+)\)$/);
if (hslMatch) {
const parts = hslMatch[1].split(',').map(p => p.trim());
const h = parseFloat(parts[0]);
const s = parseFloat(parts[1].replace('%', '')) / 100;
const l = parseFloat(parts[2].replace('%', '')) / 100;
const a = parts[3] !== undefined ? parseFloat(parts[3]) : 1;
return Color.fromHSLA(h, s, l, a);
}
throw new Error(`Unsupported color format: ${str}`);
}
}
// 基本命名色表(可擴充完整 148 色)
const NAMED_COLORS = {
transparent: '#00000000', black: '#000', white: '#fff', red: '#f00',
green: '#008000', blue: '#00f', gray: '#808080', /* ... */
};
Color.prototype = {
toHex(includeAlpha = false) {
const toHex = n => n.toString(16).padStart(2, '0');
let hex = `#${toHex(this.r)}${toHex(this.g)}${toHex(this.b)}`;
if (includeAlpha || this.a < 1) hex += toHex(Math.round(this.a * 255));
return hex.toUpperCase();
},
toRGB() { return `rgb(${this.r}, ${this.g}, ${this.b})`; },
toRGBA() { return `rgba(${this.r}, ${this.g}, ${this.b}, ${this.a.toFixed(2)})`; },
toHSL() {
const [h, s, l] = rgbToHsl(this.r, this.g, this.b);
return `hsl(${h}, ${s}%, ${l}%)`;
},
toHSLA() {
const [h, s, l] = rgbToHsl(this.r, this.g, this.b);
return `hsla(${h}, ${s}%, ${l}%, ${this.a.toFixed(2)})`;
},
toString() { return this.toRGBA(); }, // 預設輸出 rgba
toJSON() { return this.toHex(true); },
// 運算方法
clone() { return new Color(this.r, this.g, this.b, this.a); },
darken(percent) { return this.mix(Color.fromHex('#000'), percent); },
lighten(percent) { return this.mix(Color.fromHex('#fff'), percent); },
mix(other, weight = 0.5) {
const w = Math.max(0, Math.min(1, weight));
return new Color(
this.r + (other.r - this.r) * w,
this.g + (other.g - this.g) * w,
this.b + (other.b - this.b) * w,
this.a + (other.a - this.a) * w
);
}
};
// 解析各種格式
const c1 = Color.parse('#ff6600'); // HEX
const c2 = Color.parse('rgb(255, 102, 0)'); // RGB
const c3 = Color.parse('rgba(255,102,0,0.8)'); // RGBA
const c4 = Color.parse('hsl(24, 100%, 50%)'); // HSL
const c5 = Color.parse('hsla(24, 100%, 50%, 0.8)'); // HSLA
const c6 = Color.parse('orange'); // 命名色
// 互相轉換
console.log(c1.toHex()); // #FF6600
console.log(c1.toRGBA()); // rgba(255, 102, 0, 1.00)
console.log(c1.toHSLA()); // hsla(24, 100%, 50%, 1.00)
// 運算
const gradient = c1.lighten(0.3).toHex(); // #FF9933
const mixed = c1.mix(Color.parse('#00f'), 0.5).toHex(); // #803380
// 驗證
try { Color.parse('invalid'); } catch (e) { console.log('Invalid color'); }
type ColorFormat = 'hex' | 'rgb' | 'rgba' | 'hsl' | 'hsla' | 'named';
interface ColorInput { r: number; g: number; b: number; a?: number; }
interface ParseOptions { format?: ColorFormat; }
declare class Color {
readonly r: number; readonly g: number; readonly b: number; readonly a: number;
static fromRGB(r: number, g: number, b: number): Color;
static fromRGBA(r: number, g: number, b: number, a: number): Color;
static fromHex(hex: string): Color;
static fromHSL(h: number, s: number, l: number): Color;
static fromHSLA(h: number, s: number, l: number, a: number): Color;
static parse(str: string): Color;
toHex(includeAlpha?: boolean): string;
toRGB(): string;
toRGBA(): string;
toHSL(): string;
toHSLA(): string;
clone(): Color;
darken(percent: number): Color;
lighten(percent: number): Color;
mix(other: Color, weight?: number): Color;
}
HEX_REGEX、rgbMatch 等提升至模組層級r/g/b/a 屬性,繞過字串解析顏色格式轉換雖非高難度,但邊界情況多(縮寫 HEX、百分比 HSL、命名色、alpha 通道)。將核心數學封裝為 Color 類別,暴露 parse 統一入口與多種 to* 輸出,並提供 mix/darken/lighten 運算,即可滿足 99% 前端場景。建議發布為內部 npm 套件 @your-org/color-utils,統一全公司專案的顏色處理標準。