rgbToHex

Converts an RGB(A) color into a hex color string.

r/g/b are clamped to 0-255 and rounded to the nearest integer before formatting. The alpha channel is only appended (as #rrggbbaa) when it is below 1 — fully opaque colors format as the plain 6-digit #rrggbb.

Available since v3.0.0

Import

import { rgbToHex } from '@helpers4/color';
// or, from the all-in-one package (same code, one install):
import { rgbToHex } from 'helpers4/color';

Signature

rgbToHex(color: RgbColor): string

Parameters

Parameter	Type	Description
color	RgbColor	The color to convert. `a` defaults to 1 (opaque) when omitted.

Returns

string — A lowercase hex color string

Examples

Format an opaque color as hex

Alpha defaults to 1 (opaque) and is omitted from the output.

rgbToHex({ r: 255, g: 0, b: 0 })
// => '#ff0000'

Include alpha when the color is translucent

A non-opaque color formats as an 8-digit #rrggbbaa string.

rgbToHex({ r: 0, g: 255, b: 0, a: 0.5 })
// => '#00ff0080'

Related Types

RgbColor

An RGB(A) color with channels expressed as plain numbers, convenient for further conversion or manipulation.

interface RgbColor {
  a?: number;
  b: number;
  g: number;
  r: number;
}

Source

View source on GitHub