zeek/color

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

1.3.1 2022-04-11 11:24 UTC

This package is auto-updated.

Last update: 2024-09-11 17:06:17 UTC


README

Build Status StyleCI

Stories in Ready Stories in Progress Stories in Done

一个用于转换和修改颜色的微型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)

这两个方法中的amount都是一个百分比。例如:

<?php

use Liquidpineapple\Color;

$primaryColor = '#1E90FF';

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

2b. 饱和度

与亮度类似,您也可以使用以下方法修改给定颜色的饱和度:

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

这两个方法中的amount都是一个百分比。例如:

<?php

use Liquidpineapple\Color;

$dullColor = '#C44';

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

贡献

我们遗漏了什么,或者你有好的想法?请随时贡献!

如何贡献

  1. 从仓库中分叉。
  2. 编写代码(带有注释)。
  3. 编写测试(100%覆盖率)。
  4. 创建pull请求。
  5. 获利!