若要在 JavaScript 中將十六進位色碼轉換為 RGB,請先將 CSS 縮寫式十六進位色碼展開成每個色通道 2 個位數,再將每一組配對依 16 進位解析,以取得範圍為 0 至 255 的通道位元組。

確切的解析規則很重要,因為 CSS 支援數種十六進位長度,而且只有部分格式包含透明度。可靠的 JavaScript 函式應先驗證完整代碼,再將其分割,同時保留正確的通道順序,並為需要整數而非 CSS 字串的程式碼提供個別數值。

convert hex to rgb in js
在 JS 中將 HEX 轉換為 RGB:可重複使用的 JavaScript 程式碼

JavaScript 所需的通道運算

在 6 位數的 #RRGGBB 表示法中,第一組配對代表紅色,第二組代表綠色,第三組代表藍色。對應的 JavaScript 運算為 parseInt(channelPair, 16),其中 channelPair 是 2 個字元的十六進位字串。結果是 0 至 255 之間的整數位元組。

3 位數和 4 位數的值必須先展開,才能進行該運算。每個縮寫位數都會重複一次,使 1 個位數變成 2 個十六進位位數,進而構成一個完整的通道。8 位數的 CSS 顏色還包含最後一組 alpha 配對。其不透明度為 alpha 位元組除以 255。

CSS 格式 結構 Alpha 行為
#RGB 將 3 個縮寫位數展開為 6 個位數 未指定 alpha;預覽完全不透明
#RGBA 將 4 個縮寫位數展開為 8 個位數 包含最後一個 alpha 位元組
#RRGGBB 每個 RGB 通道各有 2 個位數 未指定 alpha;預覽完全不透明
#RRGGBBAA 每個 RGB 通道與 alpha 各有 2 個位數 Alpha 位於最後,也就是藍色之後

這些格式遵循 MDN 的 CSS 十六進位色碼參考資料以及CSS Color Level 4 十六進位表示法。其他顏色語法屬於不同的輸入格式,並非此轉換可接受的變體。

建立可重複使用的 JavaScript 轉換器

下列函式會驗證整個代碼、展開縮寫表示法、將每一組配對轉換為整數,並同時傳回 CSS 與各通道層級的輸出。

JavaScript: function cssHexToRgb(input) { if (typeof input !== "string") throw new Error("Expected a CSS hex color."); const hex = input.trim(); const match = /^#([0-9a-f]{3}|[0-9a-f]{4}|[0-9a-f]{6}|[0-9a-f]{8})$/i.exec(hex); if (!match) throw new Error("Use #RGB, #RGBA, #RRGGBB, or #RRGGBBAA."); const digits = match[1]; const expanded = digits.length <= 4 ? [...digits].map((digit) => digit + digit).join("") : digits; const [r, g, b, a] = expanded.match(/../g).map((part) => parseInt(part, 16)); const alphaByte = a; const alpha = alphaByte === undefined ? undefined : Number((alphaByte / 255).toFixed(3)); return { hex: `#${expanded.toLowerCase()}`, r, g, b, alphaByte, alpha, css: alphaByte === undefined ? `rgb(${r}, ${g}, ${b})` : `rgba(${r}, ${g}, ${b}, ${alpha})` }; }

正規表示式會檢查完整的值,而不會讓 parseInt 接受看似有效的前綴。去除空白會移除代碼周圍的空白,但不會允許代碼內部含有空格。大寫與小寫字母是等价的。傳回的 hex 值會規範化為小寫,而 alphaByte 則保留易讀 CSS 不透明度背後的確切整數。

在 JavaScript 專案中使用轉換器

  1. 將 cssHexToRgb 儲存在負責你的色彩處理的模組或指令碼中。
  2. 將完整 CSS 代碼(包括開頭的 #)傳給函式。當值來自表單或設定時,可以使用類似 const result = cssHexToRgb(userInput); 的呼叫。
  3. 當 API、canvas 運算、設計代碼或測試固定資料需要個別整數通道時,讀取 result.r、result.g 和 result.b。
  4. 將 result.css 用於樣式宣告,例如指派給 element.style.color。函式在沒有 alpha 時傳回 rgb(),有 alpha 時則傳回 rgba()。
  5. 當使用者可以輸入該值時,請在呼叫外包裝錯誤處理遭拒絕的代碼應產生輸入錯誤,而不是包含部分已解析通道的物件。

將驗證、通道解析與格式化集中在同一個函式中,可避免應用程式的不同部分對縮寫展開方式或 alpha 順序產生分歧,也能讓呼叫端清楚選擇現成可用的 CSS 字串或個別數值。

使用瀏覽器轉換器檢查代碼

當你需要在不撰寫程式碼的情況下檢查某種顏色時,HEX 轉 RGB 轉換器可解析 CSS 十六進位顏色,並顯示規範化後的值、通道位元組、CSS 表示法、alpha 資訊與即時預覽。

  1. 貼上以 # 開頭的 CSS 十六進位顏色。可接受的格式為 #RGB、#RGBA、#RRGGBB 和 #RRGGBBAA。
  2. 讀取展開後的小寫十六進位值,以及產生的 rgb() 或 rgba() 字串。
  3. 當結果將作為數值資料使用時,檢查個別的紅、綠、藍與 alpha 值。
  4. 檢查即時預覽,以找出明顯的通道順序錯誤。
  5. 對於半透明顏色,若四捨五入後的小數無法精確保留原始值,請保留確切的 alpha 位元組。

轉換會立即在目前的瀏覽器中進行。解析、驗證、格式化與預覽算繪皆在本機執行,色彩字串不會上傳至 Lizely。空白或無效的輸入會以明確錯誤取代先前的轉換結果,而不會讓螢幕上殘留過時的成功結果。

讓 alpha 保持正確順序

CSS 在 #RRGGBBAA 中將透明度放在最後。紅色在前,接著是綠色、藍色,alpha 則是第 4 個。部分 CSS 之外使用的 8 位數慣例會將不透明度放在最前面,但 CSS 解析器不應默默重新解讀或重新排列這些值。

以一個完整範例而言,#0f08 會展開為 #00ff0088。其通道位元組分別為紅色 0、綠色 255、藍色 0,alpha 136。CSS 不透明度計算為 136 / 255 = 0.533333...,顯示至小數點後三位時為 0.533。當這個微小的四捨五入差異很重要時,仍可取得確切位元組 136 與規範化後的十六進位值。

3 位數和 6 位數的值未指定 alpha,因此預覽會視為完全不透明。對於半透明顏色,若往返轉換的精確度很重要,請保留規範化後的 8 位數十六進位值或確切 alpha 位元組;rgba() 中的短小數主要是為了易讀。

讓每種輸出配合其使用情境

轉換表示法並不會讓每種輸出都同樣適合所有工作。請選擇將使用該顏色的系統所預期的表示法。

輸出 適用用途 重要細節
RGB 通道位元組 Canvas 運算、API、影像編輯器、測試固定資料與設計代碼 範圍為 0 至 255 的個別整數值
確切 alpha 位元組 需要精確透明度的系統 僅在來源包含 alpha 時出現
CSS 顏色字串 樣式表與內嵌樣式屬性 依情況使用 rgb() 或 rgba()
規範化十六進位值 設計代碼、固定資料與精確的顏色往返轉換 展開為小寫,存在 alpha 時保留確切 alpha 位元組

當目的端 API 要求分別提供紅色、綠色與藍色時,請使用整數通道。當瀏覽器或樣式表接受函式形式的顏色表示法時,請使用 CSS 輸出。精確共用時請使用規範化十六進位值,尤其是在半透明值的 alpha 無法以短小數完整表示時。

刻意拒絕格式錯誤的代碼

嚴格的解析器應讓無效輸入清楚可見,而不是猜測作者的原意。可接受的 CSS 邊界排除了數個設計應用程式可能容忍的值。

  • 缺少井號是無效的,因此 RGB 和 123456 不會被接受為 CSS 十六進位代碼。
  • 僅允許 3、4、6 或 8 個十六進位位數。5 位數和 7 位數的值不會被轉換。
  • 重複的井號、內嵌空格,以及 0–9 和 A–F 以外的字元都會被拒絕。
  • 大寫與小寫字母具有相同意義,但完整值周圍的空白可能會被去除。

此轉換器不會解析 rebeccapurple 等具名顏色,也不會解析以 hsl()、lab()、lch()、color() 撰寫的輸入、系統顏色、CSS 變數、漸層或以逗號分隔的色票。它也不會將 #AARRGGBB 視為 CSS 的 alpha 優先表示法,或重新排列其組成項目。

了解預覽無法證明的事項

即時預覽有助於找出明顯錯誤,但它並不是色彩管理參考資料。螢幕、瀏覽器設定檔、亮度設定、環境光源與廣色域工作流程,都可能讓相同的數值 sRGB 呈現不同外觀。CSS 十六進位顏色代表 sRGB 通道;它們不是 Pantone 參考資料、CMYK 墨色配方或實體測量值。

此轉換也不會測量對比、選擇無障礙前景色、從影像取樣像素,或在色彩空間之間轉換。對於文字與背景的配對,請使用色彩對比檢查器,而不是依色彩預覽判斷可讀性。可靠的工作流程會驗證預期的位數、確認 CSS 的 alpha 最後順序,並將顯示的通道值與將使用該值的系統進行比較。

相關閱讀:PDF 的 RGB 轉 CMYK:實用的逐色工作流程。

相關閱讀:將 RGB 轉換為 HEX 時,ABC 縮寫形式是否有效?。