andrey-helldar/black-or-white-text-color

This package is abandoned and no longer maintained. The author suggests using the andrey-helldar/which-color package instead.

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

4.0.0 2022-09-04 15:18 UTC

Requires

• php: ^8.1
• dragon-code/simple-dto: ^2.3
• dragon-code/support: ^6.0

Requires (Dev)

• phpunit/phpunit: ^9.5
• symfony/var-dumper: ^6.1

MIT

• Andrey Helldar

• color
• dragon
• which color
• text-color
• andrey-helldar
• dragon-code

README

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

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

License

This package is licensed under the MIT License.