Skip to content

Commit ea26564

Browse files
committed
[css3-cascade] Improve linking, abstract, changes section, etc.
1 parent c8461b1 commit ea26564

2 files changed

Lines changed: 147 additions & 71 deletions

File tree

css3-cascade/Overview.html

Lines changed: 112 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -87,10 +87,12 @@ <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 13 December
8787

8888
<h2 class="no-num no-toc" id=abstract>Abstract</h2>
8989

90-
<p> This CSS3 module describes how to collate style rules and assign values
91-
to all properties on all elements. Values either come from style sheets or
92-
the property's initial value. By way of cascading and inheritance, values
93-
are propagated to all properties on all elements.
90+
<p> This CSS module describes how to collate style rules and assign values
91+
to all properties on all elements. By way of cascading and inheritance,
92+
values are propagated for all properties on all elements. <a
93+
href="http://www.w3.org/TR/CSS/">CSS</a> is a language for describing the
94+
rendering of structured documents (such as HTML and XML) on screen, on
95+
paper, in speech, etc.
9496

9597
<h2 class="no-num no-toc" id=status-of-this-document> Status of this
9698
document</h2>
@@ -178,9 +180,8 @@ <h2 class="no-num no-toc" id=table-of-contents> Table of contents</h2>
178180
<li><a href="#inheritance"><span class=secno>4.3.2. </span>
179181
Inheritance: the ‘<code class=css>inherit</code>’ keyword </a>
180182

181-
<li><a href="#default-keyword"><span class=secno>4.3.3. </span>
182-
Rolling back the cascade: the ‘<code class=css>default</code>
183-
keyword</a>
183+
<li><a href="#default"><span class=secno>4.3.3. </span> Rolling back
184+
the cascade: the ‘<code class=css>default</code>’ keyword</a>
184185
</ul>
185186
</ul>
186187

@@ -205,6 +206,12 @@ <h2 class="no-num no-toc" id=table-of-contents> Table of contents</h2>
205206

206207
<li><a href="#conformance"><span class=secno>6. </span>Conformance</a>
207208

209+
<li><a href="#changes"><span class=secno>7. </span> Changes</a>
210+
<ul class=toc>
211+
<li><a href="#changes-2012"><span class=secno>7.1. </span> Changes since
212+
the 15 December 2005 Working Draft</a>
213+
</ul>
214+
208215
<li class=no-num><a href="#acknowledgments">Acknowledgments</a>
209216

210217
<li class=no-num><a href="#references">References</a>
@@ -232,13 +239,14 @@ <h2 id=introduction><span class=secno>1. </span>Introduction</h2>
232239

233240
<p> The opposite problem arises when no declarations try to set a the value
234241
for an element/property combination. In this case, a value must be found
235-
by way of <em>inheritance</em> or by looking at the property's <a
236-
href="#initial-value"><em>initial value</em></a>.
242+
by way of <a href="#inherit"><em>inheritance</em></a> or by looking at the
243+
property's <a href="#initial-value"><em>initial value</em></a>.
237244

238245
<p> The rules for finding the specified value for all properties on all
239-
elements are described in this specification. The rules for finding the
240-
specified values in the page context and the margin boxes are described in
241-
<a href="#CSS3PAGE" rel=biblioentry>[CSS3PAGE]<!--{{CSS3PAGE}}--></a>.
246+
elements in the document are described in this specification. The rules
247+
for finding the specified values in the page context and its margin boxes
248+
are described in <a href="#CSS3PAGE"
249+
rel=biblioentry>[CSS3PAGE]<!--{{CSS3PAGE}}--></a>.
242250

243251
<h2 id=at-import><span class=secno>2. </span> Importing style sheets: the
244252
<a href="#atimport"><code class=css>@import</code></a>’ rule</h2>
@@ -479,7 +487,7 @@ <h3 id=cascade><span class=secno>4.2. </span> Cascading Declarations</h3>
479487
in descending order of importance:
480488

481489
<dl>
482-
<dt id=cascade-step-origin>Origin
490+
<dt id=cascade-origin>Origin
483491

484492
<dd> The origin of a declaration is based on where it comes from and
485493
whether or not it is declared ‘<code class=css>!important</code>
@@ -514,7 +522,7 @@ <h3 id=cascade><span class=secno>4.2. </span> Cascading Declarations</h3>
514522
<p> Declarations from origins earlier in this list win over declarations
515523
from later origins.
516524

517-
<dt id=cascade-step-scope>Scope
525+
<dt id=cascade-scope>Scope
518526

519527
<dd> A declaration can be <dfn id=scoped>scoped</dfn> to a subtree of the
520528
document so that it only affects its <dfn id=scoping-element>scoping
@@ -544,7 +552,7 @@ <h3 id=cascade><span class=secno>4.2. </span> Cascading Declarations</h3>
544552
other author rules. <a href="#CSS21"
545553
rel=biblioentry>[CSS21]<!--{{CSS21}}--></a>
546554

547-
<dt id=cascade-step-specificity>Specificity
555+
<dt id=cascade-specificity>Specificity
548556

549557
<dd> The <a href="http://www.w3.org/TR/selectors/#specificity">Selectors
550558
module</a> <a href="#SELECT"
@@ -556,7 +564,7 @@ <h3 id=cascade><span class=secno>4.2. </span> Cascading Declarations</h3>
556564
selector. The declaration belonging to a ruleset whose selector has the
557565
highest specificity wins.
558566

559-
<dt id=cascade-step-order>Order of appearance.
567+
<dt id=cascade-order>Order of appearance.
560568

561569
<dd> Rules from imported style sheets are treated as if their stylesheets
562570
were substituted in place of the ‘<a href="#atimport"><code
@@ -690,9 +698,9 @@ <h4 id=preshint><span class=secno>4.2.3. </span> Precedence of Non-CSS
690698
<p class=note> Presentational hints entering the cascade at the UA level
691699
can be overridden by user styles. Presentational hints entering the
692700
cascade at the author level can be overridden by the author's use of the
693-
<code class=css>default</code>’ keyword. Host languages should choose
694-
the appropriate level for presentational hints with these considerations
695-
in mind.
701+
<a href="#default-keyword"><code class=css>default</code></a>
702+
keyword. Host languages should choose the appropriate level for
703+
presentational hints with these considerations in mind.
696704

697705
<h4 id=cascaded-value><span class=secno>4.2.4. </span> The Cascaded Value</h4>
698706

@@ -702,46 +710,48 @@ <h4 id=cascaded-value><span class=secno>4.2.4. </span> The Cascaded Value</h4>
702710
rollback steps have been performed, see below). If the <a
703711
href="#output-of-the-cascade"><i>output of the cascade</i></a> is an empty
704712
list, the <a href="#cascaded-value0"><i>cascaded value</i></a> is the
705-
<code class=css>inherit</code>’ keyword if the property is an <a
706-
href="#inherited-properties"><i>inherited property</i></a> (as defined by
707-
its property definition table) or the ‘<code class=css>initial</code>
713+
<a href="#inherit-keyword"><code class=css>inherit</code></a>
714+
keyword if the property is an <a href="#inherited-properties"><i>inherited
715+
property</i></a> (as defined by its property definition table) or the
716+
<a href="#initial-keyword"><code class=css>initial</code></a>
708717
keyword otherwise.
709718

710719
<h3 id=defaulting><span class=secno>4.3. </span> Inheritance and Defaulting</h3>
711720

712721
<p> In most cases, the <a href="#specified-value"><i>specified
713722
value</i></a> is the <a href="#cascaded-value0"><i>cascaded value</i></a>.
714-
However, the ‘<code class=css>initial</code>’, ‘<code
715-
class=css>inherit</code>’, and ‘<code class=css>default</code>
716-
values are handled specially when they are the <a
717-
href="#cascaded-value0"><i>cascaded value</i></a> of a property.
723+
However, the ‘<a href="#initial-keyword"><code
724+
class=css>initial</code></a>’, ‘<a href="#inherit-keyword"><code
725+
class=css>inherit</code></a>’, and ‘<a href="#default-keyword"><code
726+
class=css>default</code></a>’ values are handled specially when they are
727+
the <a href="#cascaded-value0"><i>cascaded value</i></a> of a property.
718728

719-
<h4 id=initial><span class=secno>4.3.1. </span> Initial value: the ‘<code
720-
class=css>initial</code>’ keyword</h4>
729+
<h4 id=initial><span class=secno>4.3.1. </span> Initial value: the ‘<a
730+
href="#initial-keyword"><code class=css>initial</code></a>’ keyword</h4>
721731

722732
<p> Each property has an <dfn id=initial-value>initial value</dfn>, defined
723733
in the property's definition table. If the <a
724-
href="#cascaded-value0"><i>cascaded value</i></a> is the <code
725-
class=css>initial</code>’ keyword, the property's <a
726-
href="#initial-value"><i>initial value</i></a> becomes its <a
727-
href="#specified-value"><i>specified value</i></a>.
734+
href="#cascaded-value0"><i>cascaded value</i></a> is the <dfn
735+
id=initial-keyword><code class=css>initial</code></dfn> keyword, the
736+
property's <a href="#initial-value"><i>initial value</i></a> becomes its
737+
<a href="#specified-value"><i>specified value</i></a>.
728738

729-
<h4 id=inheritance><span class=secno>4.3.2. </span> Inheritance: the
730-
<code class=css>inherit</code>’ keyword</h4>
739+
<h4 id=inheritance><span class=secno>4.3.2. </span> Inheritance: the<a
740+
href="#inherit-keyword"><code class=css>inherit</code></a>’ keyword</h4>
731741

732742
<p> Some properties are <dfn id=inherited-properties
733743
title="inherited property|inherited properties">inherited
734744
properties</dfn>, as defined in their property definition table. This
735745
means that, unless the cascade results in a value, the value will be
736746
determined by inheritance.
737747

738-
<p> Inheritance propagates property values from parent elements to their
739-
children. The <dfn id=inherited-value>inherited value</dfn> of a property
740-
on an element is the <a href="#computed-value"><i>computed value</i></a>
741-
of the property on the element's parent element. For the root element,
742-
which has no parent element, the <a href="#inherited-value"><i>inherited
743-
value</i></a> is the <a href="#initial-value"><i>initial value</i></a> of
744-
the property.
748+
<p> <dfn id=inherit>Inheritance</dfn> propagates property values from
749+
parent elements to their children. The <dfn id=inherited-value>inherited
750+
value</dfn> of a property on an element is the <a
751+
href="#computed-value"><i>computed value</i></a> of the property on the
752+
element's parent element. For the root element, which has no parent
753+
element, the <a href="#inherited-value"><i>inherited value</i></a> is the
754+
<a href="#initial-value"><i>initial value</i></a> of the property.
745755

746756
<p> Pseudo-elements inherit according to a fictional tag sequence described
747757
for each pseudo-element <a href="#SELECT"
@@ -753,25 +763,29 @@ <h4 id=inheritance><span class=secno>4.3.2. </span> Inheritance: the
753763
boxes</a>, or otherwise affected by manipulations of the box tree.
754764

755765
<p> If the <a href="#cascaded-value0"><i>cascaded value</i></a> of a
756-
property is the ‘<code class=css>inherit</code>’ keyword, the <a
766+
property is the <dfn id=inherit-keyword><code
767+
class=css>inherit</code></dfn> keyword, the <a
757768
href="#inherited-value"><i>inherited value</i></a> becomes the property's
758769
<i>specified</i> and <a href="#computed-value"><i>computed values</i></a>.
759770

760-
<h4 id=default-keyword><span class=secno>4.3.3. </span> Rolling back the
761-
cascade: the ‘<code class=css>default</code>’ keyword</h4>
771+
<h4 id=default><span class=secno>4.3.3. </span> Rolling back the cascade:
772+
the ‘<a href="#default-keyword"><code class=css>default</code></a>
773+
keyword</h4>
762774

763-
<p> CSS Cascading and Inheritance Level 3 introduces the <code
764-
class=css>default</code>’ keyword as a <a
765-
href="http://www.w3.org/TR/css3-values/#common-keywords">CSS-wide
775+
<p> CSS Cascading and Inheritance Level 3 introduces the <dfn
776+
id=default-keyword><code class=css>default</code></dfn> keyword as a
777+
<a href="http://www.w3.org/TR/css3-values/#common-keywords">CSS-wide
766778
keyword</a> accepted by all properties.
767779

768780
<p> If the <a href="#cascaded-value0"><i>cascaded value</i></a> is the
769-
<code class=css>default</code>’ keyword, then the origin level to
770-
which it belongs is discarded from the cascade, resulting in a new <a
771-
href="#cascaded-value0"><i>cascaded value</i></a>. This continues until
772-
the <a href="#cascaded-value0"><i>cascaded value</i></a> is not ‘<code
773-
class=css>default</code>’ or until the <a
774-
href="#output-of-the-cascade"><i>output of the cascade</i></a> is empty.
781+
<a href="#default-keyword"><code class=css>default</code></a>
782+
keyword, then the origin level to which it belongs is discarded from the
783+
cascade, resulting in a new <a href="#cascaded-value0"><i>cascaded
784+
value</i></a>. This continues until the <a
785+
href="#cascaded-value0"><i>cascaded value</i></a> is not ‘<a
786+
href="#default-keyword"><code class=css>default</code></a>’ or until the
787+
<a href="#output-of-the-cascade"><i>output of the cascade</i></a> is
788+
empty.
775789

776790
<h2 id=value-stages><span class=secno>5. </span> Stages of Value
777791
Computation</h2>
@@ -836,8 +850,8 @@ <h3 id=computed><span class=secno>5.2. </span> Finding the computed value</h3>
836850
without formatting the document.
837851

838852
<p class=note> The <a href="#computed-value"><i>computed value</i></a> is
839-
the value that is transferred from parent to child during
840-
<i>inheritance</i>.
853+
the value that is transferred from parent to child during <a
854+
href="#inherit"><i>inheritance</i></a>.
841855

842856
<p> The <a href="#computed-value"><i>computed value</i></a> exists even
843857
when the property does not apply (as defined by the "Applies To" line).
@@ -1075,9 +1089,36 @@ <h2 id=conformance><span class=secno>6. </span>Conformance</h2>
10751089

10761090
<p>[TBD]
10771091

1092+
<h2 id=changes><span class=secno>7. </span> Changes</h2>
1093+
1094+
<h3 id=changes-2012><span class=secno>7.1. </span> Changes since the 15
1095+
December 2005 Working Draft</h3>
1096+
1097+
<p>The following major changes were made to this specification since the <a
1098+
href="http://www.w3.org/TR/2005/WD-css3-cascade-20051215/">15 December
1099+
2005 Working Draft</a>:
1100+
1101+
<ul>
1102+
<li>Dropped alternate style sheets feature.
1103+
1104+
<li>Resync'd spec against <a
1105+
href="http://www.w3.org/TR/CSS21/">CSS2.1</a>.
1106+
1107+
<li>Imported <a href="#value-stages">Stages of Value Computation</a>
1108+
section from old drafts of <a
1109+
href="http://www.w3.org/TR/css3-values/">CSS Values and Units</a>.
1110+
1111+
<li>Introduced <a href="#cascade-scope">scoping</a> per <a
1112+
href="http://www.w3.org/mid/4F570227.8060707@mit.edu">Boris Zbarsky's
1113+
suggestion</a>.
1114+
1115+
<li>Introduced ‘<a href="#default-keyword"><code
1116+
class=css>default</code></a>’ keyword.
1117+
</ul>
1118+
10781119
<h2 class=no-num id=acknowledgments>Acknowledgments</h2>
10791120

1080-
<p>David Baron contributed to this specification.
1121+
<p>David Baron and Boris Zbarsky contributed to this specification.
10811122

10821123
<h2 class=no-num id=references>References</h2>
10831124

@@ -1226,9 +1267,20 @@ <h2 class=no-num id=index>Index</h2>
12261267
<li>conditional import, <a href="#conditional-imports"
12271268
title="section 2."><strong>2.</strong></a>
12281269

1270+
<li><a href="#default-keyword"><code class=css>default</code></a>’,
1271+
<a href="#default-keyword"
1272+
title="section 4.3.3."><strong>4.3.3.</strong></a>
1273+
12291274
<li><a href="#atimport"><code class=css>@import</code></a>’, <a
12301275
href="#atimport" title="section 2."><strong>2.</strong></a>
12311276

1277+
<li><a href="#inherit-keyword"><code class=css>inherit</code></a>’,
1278+
<a href="#inherit-keyword"
1279+
title="section 4.3.2."><strong>4.3.2.</strong></a>
1280+
1281+
<li>Inheritance, <a href="#inherit"
1282+
title="section 4.3.2."><strong>4.3.2.</strong></a>
1283+
12321284
<li>inherited properties, <a href="#inherited-properties"
12331285
title="section 4.3.2."><strong>4.3.2.</strong></a>
12341286

@@ -1238,6 +1290,10 @@ <h2 class=no-num id=index>Index</h2>
12381290
<li>inherited value, <a href="#inherited-value"
12391291
title="section 4.3.2."><strong>4.3.2.</strong></a>
12401292

1293+
<li><a href="#initial-keyword"><code class=css>initial</code></a>’,
1294+
<a href="#initial-keyword"
1295+
title="section 4.3.1."><strong>4.3.1.</strong></a>
1296+
12411297
<li>initial value, <a href="#initial-value"
12421298
title="section 4.3.1."><strong>4.3.1.</strong></a>
12431299

0 commit comments

Comments
 (0)