go-webcolors: Golang实现的Web颜色处理库

go-webcolors是一个模仿Python webcolors库功能的Golang实现，用于处理Web开发中常见的颜色格式转换和操作。下面详细介绍其功能和使用方法。

安装

go get github.com/kenshaw/webcolors

主要功能

1. 颜色名称与RGB/HEX转换

package main

import (
	"fmt"
	"github.com/kenshaw/webcolors"
)

func main() {
	// 颜色名称转RGB
	rgb, err := webcolors.NameToRGB("red")
	if err != nil {
		fmt.Println("Error:", err)
	} else {
		fmt.Printf("Red in RGB: %v\n", rgb) // 输出: Red in RGB: {255 0 0}
	}

	// RGB转颜色名称
	name, err := webcolors.RGBToName(webcolors.RGB{R: 0, G: 255, B: 0})
	if err != nil {
		fmt.Println("Error:", err)
	} else {
		fmt.Printf("RGB(0,255,0) is: %s\n", name) // 输出: RGB(0,255,0) is: lime
	}

	// HEX转RGB
	hexRgb, err := webcolors.HexToRGB("#ff0000")
	if err != nil {
		fmt.Println("Error:", err)
	} else {
		fmt.Printf("#ff0000 in RGB: %v\n", hexRgb) // 输出: #ff0000 in RGB: {255 0 0}
	}

	// RGB转HEX
	hex := webcolors.RGBToHex(webcolors.RGB{R: 0, G: 128, B: 0})
	fmt.Printf("RGB(0,128,0) in HEX: %s\n", hex) // 输出: RGB(0,128,0) in HEX: #008000
}

2. CSS颜色处理

// CSS颜色名称转RGB
cssRgb, err := webcolors.CSSNameToRGB("darkorange")
if err != nil {
	fmt.Println("Error:", err)
} else {
	fmt.Printf("darkorange in RGB: %v\n", cssRgb) // 输出: darkorange in RGB: {255 140 0}
}

// CSS3颜色名称转RGB
css3Rgb, err := webcolors.CSS3NameToRGB("rebeccapurple")
if err != nil {
	fmt.Println("Error:", err)
} else {
	fmt.Printf("rebeccapurple in RGB: %v\n", css3Rgb) // 输出: rebeccapurple in RGB: {102 51 153}
}

3. 颜色格式规范化

// 规范化HEX颜色
normalizedHex := webcolors.NormalizeHex("#ABC")
fmt.Println(normalizedHex) // 输出: #aabbcc

normalizedHex = webcolors.NormalizeHex("#aabbcc")
fmt.Println(normalizedHex) // 输出: #aabbcc

4. 颜色距离计算

// 计算两个RGB颜色的欧几里得距离
color1 := webcolors.RGB{R: 255, G: 0, B: 0}   // 红色
color2 := webcolors.RGB{R: 0, G: 255, B: 0}   // 绿色
distance := webcolors.RGBDistance(color1, color2)
fmt.Printf("Color distance: %.2f\n", distance) // 输出: Color distance: 360.62

5. 查找最接近的颜色名称

// 查找最接近的颜色名称
closest, err := webcolors.ClosestName(webcolors.RGB{R: 200, G: 100, B: 50})
if err != nil {
	fmt.Println("Error:", err)
} else {
	fmt.Printf("Closest color name: %s\n", closest) // 输出: Closest color name: peru
}

// 在指定颜色列表中查找最接近的颜色
customColors := map[string]webcolors.RGB{
	"myred":    {200, 0, 0},
	"mygreen":  {0, 200, 0},
	"myyellow": {200, 200, 0},
}
closestCustom := webcolors.ClosestColor(webcolors.RGB{R: 180, G: 190, B: 0}, customColors)
fmt.Printf("Closest custom color: %s\n", closestCustom) // 输出: Closest custom color: myyellow

高级用法

自定义颜色映射

// 添加自定义颜色
customColor := webcolors.RGB{R: 123, G: 45, B: 67}
webcolors.AddColor("mycustom", customColor)

// 使用自定义颜色
rgb, err := webcolors.NameToRGB("mycustom")
if err != nil {
	fmt.Println("Error:", err)
} else {
	fmt.Printf("Custom color: %v\n", rgb) // 输出: Custom color: {123 45 67}
}

批量处理颜色

// 批量转换颜色名称
colorNames := []string{"red", "green", "blue"}
for _, name := range colorNames {
	rgb, err := webcolors.NameToRGB(name)
	if err != nil {
		fmt.Printf("Error converting %s: %v\n", name, err)
		continue
	}
	fmt.Printf("%s: %v\n", name, rgb)
}

注意事项

1. go-webcolors支持CSS1、CSS2和CSS3标准定义的颜色名称
2. 所有RGB值范围是0-255
3. HEX颜色支持3位和6位格式
4. 错误处理很重要，特别是当颜色名称不存在时

总结

go-webcolors提供了完整的Web颜色处理功能，包括：

• 颜色名称与RGB/HEX之间的转换
• CSS颜色规范支持
• 颜色格式规范化
• 颜色距离计算
• 最近颜色查找

这个库非常适合需要在Golang中处理Web颜色相关的项目，如网页爬虫、颜色分析工具、UI开发等场景。