dragon-code/which-color

A simple helper, helping to determine what color the text will look better over a monotonous color.

v4.0.0 2022-09-04 15:18 UTC

This package is auto-updated.

Last update: 2024-09-16 18:20:25 UTC


README

Which Color

A simple helper, helping to determine what color the text will look better over a monotonous color.

Stable Version Unstable Version Total Downloads Github Workflow Status License

Installation

To get the latest version of package, simply require the project using Composer:

composer require dragon-code/which-color

Instead, you may of course manually update your require section and run composer update if you so choose:

{
    "require": {
        "dragon-code/which-color": "^4.0"
    }
}

Using

The package helps to determine what color it is better to write text over a monotonous color.

use DragonCode\WhichColor\Facades\Color;

return Color::of('#000000')->lightIsBetter(); // returned `true`. A white text color is better for black background.
return Color::of('#ffffff')->darkIsBetter(); // returned `true`. A black text color is better for white background.

return Color::of('#ffffff')->lightIsBetter(); // returned `false`. White color is not the best for white background.
return Color::of('#000000')->darkIsBetter(); // returned `false`. Black color is not the best for black background.

You can also use the converter:

use DragonCode\WhichColor\Services\Converter;

$converted = new Converter();

$rgb = $converted->hex2rgb('#fa000a'); // RGB object with [250, 0, 10]
// $rgb->red; // 250
// $rgb->green; // 0
// $rgb->blue; // 10
// $rgb->toArray(); // [250, 0, 10]

$converted->hex2rgb('#f5a'); // RGB object with [255, 85, 170]
$converted->hex2rgb('#ff55aa'); // RGB object with [255, 85, 170]

$converted->rgb2hex($rgb); // '#fa000a'
$converted->rgb2hex([250, 0, 10]); // '#fa000a'
$converted->rgb2hex(['red' => 250, 'green' => 0, 'blue' => 10]); // '#fa000a'
$converted->rgb2hex(['r' => 250, 'g' => 0, 'b' => 10]); // '#fa000a'

Example

map of colors

License

This package is licensed under the MIT License.