Skip to content

Commit 9014f6a

Browse files
tabatkinstabatkins
committed
[css-will-change] Reset to ED styling.
1 parent 5e95974 commit 9014f6a

2 files changed

Lines changed: 83 additions & 45 deletions

File tree

‎css-will-change/Overview.bs‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
<pre class='metadata'>
44
Shortname: css-will-change
55
Level: 1
6-
Status: FPWD
6+
Status: ED
77
Group: CSSWG
88
ED: http://dev.w3.org/csswg/css-will-change/
99
TR: http://www.w3.org/TR/css-will-change/

‎css-will-change/Overview.html‎

Lines changed: 82 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,48 @@
33
<title>CSS Will Change Module Level 1</title>
44
<link href=../default.css rel=stylesheet type=text/css>
55
<link href=../csslogo.ico rel="shortcut icon" type=image/x-icon>
6-
<link href=https://www.w3.org/StyleSheets/TR/W3C-WD rel=stylesheet type=text/css>
6+
<style>
7+
body {
8+
background: url("https://www.w3.org/StyleSheets/TR/logo-ED") top left no-repeat white;
9+
background-attachment: fixed;
10+
color: black;
11+
font-family: sans-serif;
12+
margin: 0 auto;
13+
max-width: 50em;
14+
padding: 2em 1em 2em 70px;
15+
}
16+
:link { color: #00C; background: transparent }
17+
:visited { color: #609; background: transparent }
18+
a[href]:active { color: #C00; background: transparent }
19+
a[href]:hover { background: #ffa }
20+
21+
a[href] img { border-style: none }
22+
23+
h1, h2, h3, h4, h5, h6 { text-align: left }
24+
h1, h2, h3 { color: #005A9C; }
25+
h1 { font: 170% sans-serif }
26+
h2 { font: 140% sans-serif }
27+
h3 { font: 120% sans-serif }
28+
h4 { font: bold 100% sans-serif }
29+
h5 { font: italic 100% sans-serif }
30+
h6 { font: small-caps 100% sans-serif }
31+
32+
.hide { display: none }
33+
34+
div.head { margin-bottom: 1em }
35+
div.head h1 { margin-top: 2em; clear: both }
36+
div.head table { margin-left: 2em; margin-top: 2em }
37+
38+
p.copyright { font-size: small }
39+
p.copyright small { font-size: small }
40+
41+
pre { margin-left: 2em }
42+
dt { font-weight: bold }
43+
44+
ul.toc, ol.toc {
45+
list-style: none;
46+
}
47+
</style>
748
</head>
849
<body class=h-entry>
950
<div class=head>
@@ -12,9 +53,9 @@
1253
</a>
1354
</p>
1455
<h1 class="p-name no-ref" id=title>CSS Will Change Module Level 1</h1>
15-
<h2 class="no-num no-toc no-ref heading settled heading" id=subtitle><span class=content>W3C First Public Working Draft,
56+
<h2 class="no-num no-toc no-ref heading settled heading" id=subtitle><span class=content>Editor’s Draft,
1657
<span class=dt-updated><span class=value-title title=20140513>13 May 2014</span></span></span></h2>
17-
<div data-fill-with=spec-metadata><dl><dt>This version:<dd><a class=u-url href=http://www.w3.org/TR/2014/WD-css-will-change-1-20140513/>http://www.w3.org/TR/2014/WD-css-will-change-1-20140513/</a><dt>Latest version:<dd><a href=http://www.w3.org/TR/css-will-change/>http://www.w3.org/TR/css-will-change/</a><dt>Editor’s Draft:<dd><a href=http://dev.w3.org/csswg/css-will-change/>http://dev.w3.org/csswg/css-will-change/</a>
58+
<div data-fill-with=spec-metadata><dl><dt>This version:<dd><a class=u-url href=http://dev.w3.org/csswg/css-will-change/>http://dev.w3.org/csswg/css-will-change/</a><dt>Latest version:<dd><a href=http://www.w3.org/TR/css-will-change/>http://www.w3.org/TR/css-will-change/</a><dt>Editor’s Draft:<dd><a href=http://dev.w3.org/csswg/css-will-change/>http://dev.w3.org/csswg/css-will-change/</a>
1859
<dt>Feedback:</dt>
1960
<dd><a href="mailto:www-style@w3.org?subject=%5Bcss-will-change%5D%20feedback">www-style@w3.org</a>
2061
with subject line
@@ -33,37 +74,34 @@ <h2 class="no-num no-toc no-ref heading settled heading" id=abstract><span class
3374
on screen, on paper, in speech, etc.</p>
3475

3576
<h2 class="no-num no-toc no-ref heading settled heading" id=status><span class=content>Status of this document</span></h2>
36-
<div data-fill-with=status><p><em>This section describes the status of this document at the time of
37-
its publication. Other documents may supersede this document. A list of
38-
current W3C publications and the latest revision of this technical report
39-
can be found in the <a href=http://www.w3.org/TR/>W3C technical reports
40-
index at http://www.w3.org/TR/.</a></em>
41-
42-
<p>This document is a <b>First Public Working Draft</b>.
43-
44-
<p>Publication as a First Public Working Draft does not imply endorsement by the W3C
45-
Membership. This is a draft document and may be updated, replaced or
46-
obsoleted by other documents at any time. It is inappropriate to cite this
47-
document as other than work in progress.
48-
49-
<p>The (<a href=http://lists.w3.org/Archives/Public/www-style/>archived</a>) public
50-
mailing list <a href=mailto:www-style@w3.org>www-style@w3.org</a> (see
51-
<a href=http://www.w3.org/Mail/Request>instructions</a>) is preferred
52-
for discussion of this specification. When sending e-mail, please put the
53-
text “css-will-change” in the subject, preferably like this:
54-
“[css-will-change] <em>…summary of comment…</em>”
55-
56-
<p>This document was produced by the <a href=http://www.w3.org/Style/CSS/members>CSS Working Group</a> (part of
57-
the <a href=http://www.w3.org/Style/>Style Activity</a>).
58-
59-
<p>This document was produced by a group operating under the <a href=http://www.w3.org/Consortium/Patent-Policy-20040205/>5 February
60-
2004 W3C Patent Policy</a>. W3C maintains a <a href=http://www.w3.org/2004/01/pp-impl/32061/status rel=disclosure>public list of any patent disclosures</a> made in
61-
connection with the deliverables of the group; that page also includes
62-
instructions for disclosing a patent. An individual who has actual
63-
knowledge of a patent which the individual believes contains <a href=http://www.w3.org/Consortium/Patent-Policy-20040205/#def-essential>Essential
64-
Claim(s)</a> must disclose the information in accordance with <a href=http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure>section
65-
6 of the W3C Patent Policy</a>.</p>
66-
</div>
77+
<div data-fill-with=status><p>
78+
This is a public copy of the editors’ draft.
79+
It is provided for discussion only and may change at any moment.
80+
Its publication here does not imply endorsement of its contents by W3C.
81+
Don’t cite this document other than as work in progress.
82+
83+
<p>
84+
The (<a href=http://lists.w3.org/Archives/Public/www-style/>archived</a>) public mailing list
85+
<a href="mailto:www-style@w3.org?Subject=%5Bcss-will-change%5D%20PUT%20SUBJECT%20HERE">www-style@w3.org</a>
86+
(see <a href=http://www.w3.org/Mail/Request>instructions</a>)
87+
is preferred for discussion of this specification.
88+
When sending e-mail,
89+
please put the text “css-will-change” in the subject,
90+
preferably like this:
91+
“[css-will-change] <em>…summary of comment…</em>”
92+
93+
<p>
94+
This document was produced by the <a href=http://www.w3.org/Style/CSS/members>CSS Working Group</a>
95+
(part of the <a href=http://www.w3.org/Style/>Style Activity</a>).
96+
97+
<p>
98+
This document was produced by a group operating under
99+
the <a href=http://www.w3.org/Consortium/Patent-Policy-20040205/>5 February 2004 W3C Patent Policy</a>.
100+
W3C maintains a <a href=http://www.w3.org/2004/01/pp-impl/32061/status rel=disclosure>public list of any patent disclosures</a>
101+
made in connection with the deliverables of the group;
102+
that page also includes instructions for disclosing a patent.
103+
An individual who has actual knowledge of a patent which the individual believes contains <a href=http://www.w3.org/Consortium/Patent-Policy-20040205/#def-essential>Essential Claim(s)</a>
104+
must disclose the information in accordance with <a href=http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure>section 6 of the W3C Patent Policy</a>.</div>
67105
<div data-fill-with=at-risk></div>
68106

69107
<h2 class="no-num no-toc no-ref heading settled heading" id=contents><span class=content>Table of Contents</span></h2>
@@ -106,7 +144,7 @@ <h2 class="heading settled heading" data-level=1 id=intro><span class=secno>1 </
106144
and often provides significant speed benefits.
107145

108146
<p>However, setting up the element in a fresh layer is a relatively expensive operation,
109-
which can delay the start of a <a class=property data-link-type=propdesc href=http://www.w3.org/TR/css3-transforms/#propdef-transform title=transform>transform</a> animation by a noticeable fraction of a second.
147+
which can delay the start of a <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css-transforms-1/#propdef-transform title=transform>transform</a> animation by a noticeable fraction of a second.
110148
</div><p></p>
111149

112150
<p>The <a class=property data-link-type=propdesc href=#propdef-will-change title=will-change>will-change</a> property defined in this specification allows an author to declare ahead-of-time what properties are likely to change in the future,
@@ -241,7 +279,7 @@ <h2 class="heading settled heading" data-level=2 id=will-change><span class=secn
241279

242280
<table class="definition propdef"><tr><th>Name:<td><dfn class=css-code data-dfn-type=property data-export="" id=propdef-will-change>will-change<a class=self-link href=#propdef-will-change></a></dfn><tr><th>Value:<td class=prod>auto | <a class="production css-code" data-link-type=type href=#typedef-animateable-feature title="<animateable-feature>">&lt;animateable-feature&gt;</a>#<tr><th>Initial:<td>auto<tr><th>Applies to:<td>all elements<tr><th>Inherited:<td>no<tr><th>Media:<td>all<tr><th>Computed value:<td>specified value<tr><th>Percentages:<td>n/a</table>
243281

244-
<pre class=prod><dfn class=css-code data-dfn-type=type data-export="" id=typedef-animateable-feature>&lt;animateable-feature&gt;<a class=self-link href=#typedef-animateable-feature></a></dfn> = scroll-position | contents | <a class="production css-code" data-link-type=type href=http://www.w3.org/TR/css3-values/#identifier-value title="<custom-ident>">&lt;custom-ident&gt;</a></pre>
282+
<pre class=prod><dfn class=css-code data-dfn-type=type data-export="" id=typedef-animateable-feature>&lt;animateable-feature&gt;<a class=self-link href=#typedef-animateable-feature></a></dfn> = scroll-position | contents | <a class="production css-code" data-link-type=type href=http://dev.w3.org/csswg/css-values-3/#identifier-value title="<custom-ident>">&lt;custom-ident&gt;</a></pre>
245283

246284
<p>The <a class=property data-link-type=propdesc href=#propdef-will-change title=will-change>will-change</a> property provides a rendering hint to the user agent,
247285
stating what kinds of changes the author expects to perform on the element.
@@ -289,23 +327,23 @@ <h2 class="heading settled heading" data-level=2 id=will-change><span class=secn
289327
A browser might take this value as a signal to cache less aggressively on the element,
290328
or avoid caching at all and just continually re-render the element from scratch.
291329

292-
<dt><dfn class=css-code data-dfn-for=will-change data-dfn-type=value data-export="" id=valuedef-custom-ident><a class="production css-code" data-link-type=type href=http://www.w3.org/TR/css3-values/#identifier-value title="<custom-ident>">&lt;custom-ident&gt;</a><a class=self-link href=#valuedef-custom-ident></a></dfn>
330+
<dt><dfn class=css-code data-dfn-for=will-change data-dfn-type=value data-export="" id=valuedef-custom-ident><a class="production css-code" data-link-type=type href=http://dev.w3.org/csswg/css-values-3/#identifier-value title="<custom-ident>">&lt;custom-ident&gt;</a><a class=self-link href=#valuedef-custom-ident></a></dfn>
293331
<dd>
294332
Indicates that the author expects to animate or change the property with the given name on the element in the near future.
295333

296-
<p>The <a class="production css-code" data-link-type=type href=http://www.w3.org/TR/css3-values/#identifier-value title="<custom-ident>">&lt;custom-ident&gt;</a> production used here excludes the keywords <span class=css data-link-type=maybe title=will-change>will-change</span>, <span class=css data-link-type=maybe title=none>none</span>, <span class=css data-link-type=maybe title=all>all</span>, <a class=css data-link-type=maybe href=#valuedef-auto title=auto>auto</a>, <a class=css data-link-type=maybe href=#valuedef-scroll-position title=scroll-position>scroll-position</a>, and <a class=css data-link-type=maybe href=#valuedef-contents title=contents>contents</a>,
297-
in addition to the keywords normally excluded from <a class="production css-code" data-link-type=type href=http://www.w3.org/TR/css3-values/#identifier-value title="<custom-ident>">&lt;custom-ident&gt;</a>.</p>
334+
<p>The <a class="production css-code" data-link-type=type href=http://dev.w3.org/csswg/css-values-3/#identifier-value title="<custom-ident>">&lt;custom-ident&gt;</a> production used here excludes the keywords <span class=css data-link-type=maybe title=will-change>will-change</span>, <span class=css data-link-type=maybe title=none>none</span>, <span class=css data-link-type=maybe title=all>all</span>, <a class=css data-link-type=maybe href=#valuedef-auto title=auto>auto</a>, <a class=css data-link-type=maybe href=#valuedef-scroll-position title=scroll-position>scroll-position</a>, and <a class=css data-link-type=maybe href=#valuedef-contents title=contents>contents</a>,
335+
in addition to the keywords normally excluded from <a class="production css-code" data-link-type=type href=http://dev.w3.org/csswg/css-values-3/#identifier-value title="<custom-ident>">&lt;custom-ident&gt;</a>.</p>
298336

299337
<p class=note>Note: Note that most properties will have no effect when specified,
300338
as the user agent doesn’t perform any special optimizations for changes in most properties.
301339
It is still <em>safe</em> to specify them, though;
302340
it’ll simply have no effect.</p>
303341

304342
<p class=example>
305-
For example, browsers often handle elements with <a class=property data-link-type=propdesc href=http://www.w3.org/TR/css3-transforms/#propdef-transform title=transform>transform</a> set to a non-initial value very differently from normal elements,
343+
For example, browsers often handle elements with <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css-transforms-1/#propdef-transform title=transform>transform</a> set to a non-initial value very differently from normal elements,
306344
perhaps rendering them to their own “GPU layer”
307-
or using other mechanisms to make it easier to quickly make the sort of transformations that <a class=property data-link-type=propdesc href=http://www.w3.org/TR/css3-transforms/#propdef-transform title=transform>transform</a> can produce.
308-
A browser might take a value of <a class=property data-link-type=propdesc href=http://www.w3.org/TR/css3-transforms/#propdef-transform title=transform>transform</a> as a signal
345+
or using other mechanisms to make it easier to quickly make the sort of transformations that <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css-transforms-1/#propdef-transform title=transform>transform</a> can produce.
346+
A browser might take a value of <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css-transforms-1/#propdef-transform title=transform>transform</a> as a signal
309347
that it should go ahead and promote the element to its own layer immediately,
310348
before the element starts to be transformed,
311349
to avoid any delay involved in rerendering the old and new layers.
@@ -322,9 +360,9 @@ <h2 class="heading settled heading" data-level=2 id=will-change><span class=secn
322360
to avoid sudden rendering differences when the property is eventually changed.</p>
323361

324362
<p class=example>
325-
For example, setting <a class=property data-link-type=propdesc href=http://www.w3.org/TR/css3-color/#opacity title=opacity>opacity</a> to any value other than <span class=css data-link-type=maybe title=1>1</span> creates a stacking context on the element.
363+
For example, setting <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css-color-3/#opacity title=opacity>opacity</a> to any value other than <span class=css data-link-type=maybe title=1>1</span> creates a stacking context on the element.
326364
Thus, setting <a class=css data-link-type=propdesc href=#propdef-will-change title=will-change>will-change: opacity</a> also creates a stacking context,
327-
even if <a class=property data-link-type=propdesc href=http://www.w3.org/TR/css3-color/#opacity title=opacity>opacity</a> is <em>currently</em> still equal to <span class=css data-link-type=maybe title=1>1</span>.
365+
even if <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css-color-3/#opacity title=opacity>opacity</a> is <em>currently</em> still equal to <span class=css data-link-type=maybe title=1>1</span>.
328366
</dl>
329367

330368
<p>The <a class=property data-link-type=propdesc href=#propdef-will-change title=will-change>will-change</a> property has no <em>direct</em> effect on the element it is specified on,

0 commit comments

Comments
 (0)