README

一个用于转换和修改颜色的微型PHP包！ 🔥

本文档内容

• 安装
• 文档
• 贡献

安装

您可以通过composer安装此包。要将最新版本安装到您的项目中，请使用以下命令

composer require liquidpineapple/color

此包需要PHP 7.0或更高版本。

文档

目录

1. 转换

   b) 输出

   a) 类型

2. 修改

   a) 亮度

   b) 饱和度

1. 转换

您可以使用此包将颜色转换为不同的表示方法。例如，将HEX转换为RGB。

<?php

use Liquidpineapple\Color;

$rgbColor = Color::fromHEX('#1E90FF')->toRGB();
// [30, 144, 255]

1a. 输出

在某些情况下，您可能想要类似于 rgb(30, 144, 255) 的输出。这可以通过以下方法完成：

<?php

use Liquidpineapple\Color;

$rgbColor = Color::fromHEX('#1E90FF')->toRGBString();
// rgb(30, 144, 255)

1b. 类型

您可以从以下类型进行转换

• HEX: fromHEX($hex)
• RGB: fromHEX($red, $green, $blue)
• HSL: fromHSL($hue, $saturation, $lightness)
• HSV: fromHSV($hue, $saturation, $value)

转换为以下类型

• HEX: toHEX() & toHEXString() (toHEX() 的别名)
• RGB: toRGB() & toRGBString()
• HSL: toHSL() & toHSLString()
• HSV: toHSV() & toHSVString()

2. 修改

有时仅仅转换还不够，在某些情况下，您可能想要加深或增加颜色的饱和度。幸运的是，使用此包可以轻松完成。

2a. 亮度

您可以使用以下方法更改颜色的亮度

• lighten($amount)
• darken($amount)

这两个方法中的数量是一个百分比。例如：

<?php

use Liquidpineapple\Color;

$primaryColor = '#1E90FF';

$secondaryColor = Color::fromHEX('#1E90FF')->darken(10)->toHEX();
// #2A8FF4

2b. 饱和度

与亮度一样，您可以使用以下方法更改给定颜色的饱和度

• saturate($amount)
• desaturate($amount)

这两个方法中的数量是一个百分比。例如：

<?php

use Liquidpineapple\Color;

$dullColor = '#C44';

$exitingColor = Color::fromHEX('#C44')->saturate(10)->toHEX();
// #D33C3C

贡献

我们遗漏了什么，或者您有酷炫的想法？请随时贡献！

如何贡献

1. Fork此存储库。
2. 编写代码（带有注释）。
3. 编写测试（100%覆盖率）。
4. 创建拉取请求。
5. 获利！