hutool.core.util.color

颜色工具类

提供十六进制颜色与 RGB 元组之间的转换。

Module Contents

Classes

ColorUtil

颜色工具类，提供颜色格式转换。

API

class hutool.core.util.color.ColorUtil

颜色工具类，提供颜色格式转换。

static hex_to_rgb(hex_color: str) → Tuple[int, ...]

将十六进制颜色字符串转换为 RGB 元组。

支持 #RGB、#RRGGBB、RGB、RRGGBB 格式。

参数:

hex_color – 十六进制颜色字符串

返回:

RGB 元组 (r, g, b)

抛出:

ValueError – 格式不合法时

>>> ColorUtil.hex_to_rgb('#FF0000')
(255, 0, 0)
>>> ColorUtil.hex_to_rgb('#00ff00')
(0, 255, 0)
>>> ColorUtil.hex_to_rgb('369')
(51, 102, 153)

static rgb_to_hex(r: int, g: int, b: int) → str

将 RGB 值转换为十六进制颜色字符串。

参数:

• r – 红色分量（0-255）

• g – 绿色分量（0-255）

• b – 蓝色分量（0-255）

返回:

十六进制颜色字符串（#RRGGBB 格式，小写）

抛出:

ValueError – RGB 值超出范围时

>>> ColorUtil.rgb_to_hex(255, 0, 0)
'#ff0000'
>>> ColorUtil.rgb_to_hex(0, 255, 0)
'#00ff00'
>>> ColorUtil.rgb_to_hex(51, 102, 153)
'#336699'