Web Colours

Web::WEBHEX maps 150 names to hex codes: the CSS Color Module Level 4 list, plus the two Acrobat JavaScript spellings dkgray and ltgray. Any of them can be used wherever a colour string is accepted, and the lookup is case-insensitive.

Lookups

<?php

require_once __DIR__ . '/vendor/autoload.php';

$web = new \Com\Tecnick\Color\Web();

echo $web->getHexFromName('cornflowerblue'), "\n";
echo $web->getNameFromHex('#6495ed'), "\n";
echo $web->extractHexCode('#369'), "\n";
echo $web->getRgbObjFromName('cornflowerblue')->getCssColor(), "\n";

6495edff
cornflowerblue
336699ff
rgb(100,149,237)

extractHexCode() normalizes a hash: it lowercases, drops the #, and expands the three and four digit forms. getNameFromHex() is the reverse of getHexFromName() and raises for a code that is not in the table. For the closest entry rather than an exact match, see Nearest Colour.

Aliases

150 names cover 139 colours. Nine hex codes carry two or three names each: seven gray and grey spellings, plus aqua/cyan and fuchsia/magenta.

// three names for one colour
foreach (['darkgray', 'darkgrey', 'dkgray'] as $name) {
    printf("%-10s %s\n", $name, $web->getHexFromName($name));
}

// the reverse lookup returns the first name in table order
echo $web->getNameFromHex('#a9a9a9'), "\n";

darkgray   a9a9a9ff
darkgrey   a9a9a9ff
dkgray     a9a9a9ff
darkgray

The reverse lookup returns whichever name comes first in the table, which is the gray spelling in every pair that differs only in that letter.

dkgray and ltgray are not CSS names. They are in the table so the Acrobat JavaScript colour names resolve through the parser. Pdf::JSCOLOR spells them dkGray and ltGray and matches case-sensitively. See PDF Output.

rebeccapurple is present. transparent is not: it is handled before the table lookup and returns null, as Notations describes.

The Table

See Also

• tc-lib-color : the library overview.
• Notations : the other strings the parser accepts.
• Nearest Colour : finding the closest entry to an arbitrary colour.
• RGB : the model every one of these parses into.
• API reference : the generated class documentation.