1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
|
webcolors |release|
===================
This module provides utility functions for working with the color names and
color value formats defined by the HTML and CSS specifications for use in
documents on the web.
Support is included for normalizing and converting between the following
formats (RGB colorspace only; conversion to/from HSL can be handled by the
:mod:`colorsys` module in the Python standard library):
* Specification-defined color names
* Six-digit hexadecimal
* Three-digit hexadecimal
* Integer ``rgb()`` triplet
* Percentage ``rgb()`` triplet
For example::
>>> import webcolors
>>> webcolors.hex_to_name("#daa520")
'goldenrod'
Implementations are also provided for the HTML5 color parsing and serialization
algorithms. For example, parsing the infamous "chucknorris" string into an
``rgb()`` triplet::
>>> import webcolors
>>> webcolors.html5_parse_legacy_color("chucknorris")
HTML5SimpleColor(red=192, blue=0, green=0)
Documentation contents
----------------------
.. toctree::
:maxdepth: 1
install
colors
conventions
contents
conformance
changelog
faq
.. seealso::
* `The sRGB color space <http://www.w3.org/Graphics/Color/sRGB>`_
* `HTML 4: Colors <http://www.w3.org/TR/html401/types.html#h-6.5>`_
* `CSS1: Color units <http://www.w3.org/TR/CSS1/#color-units>`_
* `CSS2: Colors <http://www.w3.org/TR/CSS2/syndata.html#color-units>`_
* `CSS3 color module <http://www.w3.org/TR/css3-color/>`_
* `HTML5: Colors <http://www.w3.org/TR/html5/infrastructure.html#colors>`_
|
