Skip to content

Commit ff3e9a7

Browse files
committed
[css-color] Add color-adjust property, per WG resolution.
1 parent ff9904b commit ff3e9a7

2 files changed

Lines changed: 542 additions & 363 deletions

File tree

css-color/Overview.bs

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2326,6 +2326,81 @@ Color Management: the 'color-correction' property</h2>
23262326
Note: The initial value of this property may change in a future level of this specification.
23272327

23282328

2329+
<h2 id='color-adjust'>
2330+
Preserving Colors in Different-Capability Devices: the 'color-adjust' property</h2>
2331+
2332+
On most monitors,
2333+
the color choices that authors make have no significant difference
2334+
in terms of how the device performs;
2335+
displaying a document with a white background or a black background is approximately equally easy.
2336+
2337+
However, some devices have limitations and other qualities that make this assumption untrue.
2338+
For example,
2339+
printers tend to print on white paper;
2340+
a document with a white background thus has to spend no ink on drawing that background,
2341+
while a document with a black background will have to expend a large amount of ink filling in the background color.
2342+
This tends to look fairly bad,
2343+
and sometimes has deleterious physical effects on the paper,
2344+
not to mention the vastly increased printing cost from expending the extra ink.
2345+
Even fairly small differences,
2346+
such as coloring text black versus dark gray,
2347+
can be quite different when printing,
2348+
as it switches from using a single black ink
2349+
to a mixture of cyan, magenta, and yellow ink,
2350+
resulting in higher ink usage and lower resolution.
2351+
2352+
As a result, in some circumstances user agents will alter the styles an author specifies in some particular context,
2353+
adjusting them to be more appropriate for the output device
2354+
and to accommodate what they assume the user would prefer.
2355+
However, in some cases the document may be using colors in important, well-thought-out ways that the user would appreciate,
2356+
and so the document would like some way to hint to the user agent that it might want to respect the page's color choices.
2357+
The 'color-adjust' property controls this.
2358+
2359+
<pre class='propdef'>
2360+
Name: color-adjust
2361+
Value: economy | exact
2362+
Initial: economy
2363+
Applies to: all elements
2364+
Inherited: yes
2365+
Media: visual
2366+
Computed value: as specified
2367+
Percentages: N/A
2368+
</pre>
2369+
2370+
The 'color-adjust' property provides a hint to the user-agent about how it should treat color and style choices
2371+
that might be expensive or generally unwise on a given device,
2372+
such as using light text on a dark background in a printed document.
2373+
If user agents allow users to control this aspect of the document's display,
2374+
the user preference <strong>must</strong> be respected more strongly
2375+
than the hint provided by 'color-adjust'.
2376+
It has the following values:
2377+
2378+
<dl dfn-type=value dfn-for=color-adjust>
2379+
<dt><dfn>economy</dfn>
2380+
<dd>
2381+
The user agent should make adjustments to the page's styling
2382+
as it deems necessary and prudent for the output device.
2383+
2384+
For example, if the document is being printed,
2385+
a user agent might ignore any backgrounds
2386+
and adjust text color to be sufficiently dark,
2387+
to minimize ink usage.
2388+
2389+
<dt><dfn>exact</dfn>
2390+
<dd>
2391+
This value indicates that the page is using color and styling on the specified element
2392+
in a way which is important and significant,
2393+
and which should not be tweaked or changed except at the user's request.
2394+
2395+
For example,
2396+
a mapping website offering printed directions
2397+
might "zebra-stripe" the steps in the directions,
2398+
alternating between white and light gray backgrounds.
2399+
Losing this zebra-striping and having a pure-white background
2400+
would make the directions harder to read with a quick glance
2401+
when distracted in a car.
2402+
</dl>
2403+
23292404
<h2 id="sample">
23302405
Sample style sheet for (X)HTML</h2>
23312406

0 commit comments

Comments
 (0)