Skip to content

Commit e56d2c7

Browse files
committed
[css-cascade] Crosslink 'declaration' more often. #6837
1 parent 472343b commit e56d2c7

File tree

4 files changed

+59
-59
lines changed

4 files changed

+59
-59
lines changed

css-cascade-3/Overview.bs

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -114,7 +114,7 @@ Importing Style Sheets: the ''@import'' rule</h2>
114114
it only applies between constructs in the same stylesheet.
115115

116116
<p class='example'>
117-
For example, declarations in style rules from imported stylesheets interact with the cascade
117+
For example, [=declarations=] in style rules from imported stylesheets interact with the cascade
118118
as if they were written literally into the stylesheet at the point of the ''@import''.
119119

120120
Any ''@import'' rules must precede all other valid at-rules and style rules in a style sheet
@@ -223,14 +223,14 @@ Shorthand Properties</h2>
223223
each “missing” <a>sub-property</a> is assigned its <a>initial value</a>.
224224

225225
<div class='note'>
226-
This means that a <a>shorthand</a> property declaration always sets <em>all</em> of its <a>sub-properties</a>,
226+
This means that a <a>shorthand</a> [=property declaration=] always sets <em>all</em> of its <a>sub-properties</a>,
227227
even those that are not explicitly set.
228228
Carelessly used, this might result in inadvertently resetting some <a>sub-properties</a>.
229229
Carefully used, a <a>shorthand</a> can guarantee a “blank slate”
230230
by resetting <a>sub-properties</a> inadvertently cascaded from other sources.
231231

232232
For example, writing ''background: green'' rather than ''background-color: green''
233-
ensures that the background color overrides any earlier declarations
233+
ensures that the background color overrides any earlier [=declarations=]
234234
that might have set the background to an image with 'background-image'.
235235
</div>
236236

@@ -274,7 +274,7 @@ Shorthand Properties</h2>
274274
If a <a>shorthand</a> is specified as one of the <a href="https://www.w3.org/TR/css-values/#common-keywords">CSS-wide keywords</a> [[!css-values-3]],
275275
it sets all of its <a>sub-properties</a> to that keyword,
276276
including any that are <a>reset-only sub-properties</a>.
277-
(Note that these keywords cannot be combined with other values in a single declaration, not even in a shorthand.)
277+
(Note that these keywords cannot be combined with other values in a single [=declaration=], not even in a shorthand.)
278278

279279
Declaring a <a>shorthand</a> property to be ''!important''
280280
is equivalent to declaring all of its <a>sub-properties</a> to be ''!important''.
@@ -649,7 +649,7 @@ Examples</h3>
649649
Filtering</h2>
650650

651651
In order to find the <a>declared values</a>,
652-
implementations must first identify all declarations that apply to each element.
652+
implementations must first identify all [=declarations=] that apply to each element.
653653
A declaration applies to an element if:
654654

655655
<ul>
@@ -668,7 +668,7 @@ Filtering</h2>
668668
and the declaration's value matches the syntax for that property.
669669
</ul>
670670

671-
The values of the declarations that apply form,
671+
The values of the [=declarations=] that apply form,
672672
for each property on each element,
673673
a list of <a>declared values</a>.
674674
The next section,
@@ -692,19 +692,19 @@ Cascading</h2>
692692
The <dfn export>cascade</dfn>
693693
takes an unordered list of <a>declared values</a>
694694
for a given property on a given element,
695-
sorts them by their declaration’s precedence as determined below,
695+
sorts them by their [=declaration’s=] precedence as determined below,
696696
and outputs a single <a>cascaded value</a>.
697697

698698
<h3 id="cascade-sort">
699699
Cascade Sorting Order</h3>
700700

701-
The cascade sorts declarations according to the following criteria,
701+
The cascade sorts [=declarations=] according to the following criteria,
702702
in descending order of precedence:
703703

704704
<dl>
705705
<dt id='cascade-origin'>Origin and Importance
706706
<dd>
707-
The <a>origin</a> of a declaration is based on where it comes from
707+
The <a>origin</a> of a [=declaration=] is based on where it comes from
708708
and its <a lt="important">importance</a> is
709709
whether or not it is declared with ''!important''
710710
(see [[#importance|below]]).
@@ -805,10 +805,10 @@ Important Declarations: the ''!important'' annotation</h3>
805805
CSS attempts to create a balance of power between author and user style sheets.
806806
By default, rules in an author's style sheet override those in a user's style sheet,
807807
which override those in the user-agent's default style sheet.
808-
To balance this, a declaration can be marked [=important=],
808+
To balance this, a [=declaration=] can be marked [=important=],
809809
which increases its weight in the cascade and inverts the order of precedence.
810810

811-
A declaration is <dfn export local-lt="importance">important</dfn>
811+
A [=declaration=] is <dfn export local-lt="importance">important</dfn>
812812
if it has a ''!important'' annotation as defined by [[css-syntax-3]],
813813
i.e. if the last two (non-whitespace, non-comment) tokens
814814
in its value are the delimiter token ''!'' followed by the identifier token ''important''.

css-cascade-4/Overview.bs

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -89,14 +89,14 @@ Introduction</h2>
8989

9090
One of the fundamental design principles of CSS is <a lt="cascade">cascading</a>,
9191
which allows several style sheets to influence the presentation of a document.
92-
When different declarations try to set a value for the same element/property combination,
92+
When different [=declarations=] try to set a value for the same element/property combination,
9393
the conflicts must somehow be resolved.
9494

95-
The opposite problem arises when no declarations try to set a value for an element/property combination.
95+
The opposite problem arises when no [=declarations=] try to set a value for an element/property combination.
9696
In this case, a value is be found by way of <a>inheritance</a>
9797
or by looking at the property's <a>initial value</a>.
9898

99-
The <a href="#cascade">cascading</a> and <a href="#defaulting">defaulting</a> process takes a set of declarations as input,
99+
The <a href="#cascade">cascading</a> and <a href="#defaulting">defaulting</a> process takes a set of [=declarations=] as input,
100100
and outputs a <a>specified value</a> for each property on each element.
101101

102102
The rules for finding the specified value for all properties on all elements in the document are described in this specification.
@@ -151,7 +151,7 @@ Importing Style Sheets: the ''@import'' rule</h2>
151151
it only applies between constructs in the same stylesheet.
152152

153153
<p class='example'>
154-
For example, declarations in style rules from imported stylesheets interact with the cascade
154+
For example, [=declarations=] in style rules from imported stylesheets interact with the cascade
155155
as if they were written literally into the stylesheet at the point of the ''@import''.
156156

157157
Any ''@import'' rules must precede all other valid at-rules and style rules in a style sheet
@@ -353,14 +353,14 @@ Shorthand Properties</h2>
353353
each “missing” <a>sub-property</a> is assigned its <a>initial value</a>.
354354

355355
<div class='note'>
356-
This means that a <a>shorthand</a> property declaration always sets <em>all</em> of its <a>sub-properties</a>,
356+
This means that a <a>shorthand</a> [=property declaration=] always sets <em>all</em> of its <a>sub-properties</a>,
357357
even those that are not explicitly set.
358358
Carelessly used, this might result in inadvertently resetting some <a>sub-properties</a>.
359359
Carefully used, a <a>shorthand</a> can guarantee a “blank slate”
360360
by resetting <a>sub-properties</a> inadvertently cascaded from other sources.
361361

362362
For example, writing ''background: green'' rather than ''background-color: green''
363-
ensures that the background color overrides any earlier declarations
363+
ensures that the background color overrides any earlier [=declarations=]
364364
that might have set the background to an image with 'background-image'.
365365
</div>
366366

@@ -404,7 +404,7 @@ Shorthand Properties</h2>
404404
If a <a>shorthand</a> is specified as one of the <a href="https://www.w3.org/TR/css-values/#common-keywords">CSS-wide keywords</a> [[!css-values-3]],
405405
it sets all of its <a>sub-properties</a> to that keyword,
406406
including any that are <a>reset-only sub-properties</a>.
407-
(Note that these keywords cannot be combined with other values in a single declaration, not even in a shorthand.)
407+
(Note that these keywords cannot be combined with other values in a single [=declaration=], not even in a shorthand.)
408408

409409
Declaring a <a>shorthand</a> property to be ''!important''
410410
is equivalent to declaring all of its <a>sub-properties</a> to be ''!important''.
@@ -556,13 +556,13 @@ Value Processing</h2>
556556
or are not part of the document’s [=flattened element tree=]
557557
do not participate in CSS value processing,
558558
and do not have [=declared=], [=cascaded=], [=specified=], [=computed=], [=used=], or [=actual=] values,
559-
even if they potentially have style declarations assigned to them
559+
even if they potentially have style [=declarations=] assigned to them
560560
(for example, by a <code>style</code> attribute).
561561

562562
<h3 id="declared">
563563
Declared Values</h3>
564564

565-
Each property declaration <a href="#filtering">applied to an element</a>
565+
Each [=property declaration=] <a href="#filtering">applied to an element</a>
566566
contributes a <dfn export local-lt="declared">declared value</dfn> for that property
567567
associated with the element.
568568
See <a href="#filtering">Filtering Declarations</a> for details.
@@ -884,7 +884,7 @@ Examples</h3>
884884
Filtering</h2>
885885

886886
In order to find the <a>declared values</a>,
887-
implementations must first identify all declarations that apply to each element.
887+
implementations must first identify all [=declarations=] that apply to each element.
888888
A declaration applies to an element if:
889889

890890
<ul>
@@ -904,7 +904,7 @@ Filtering</h2>
904904
and the declaration's value matches the syntax for that property.
905905
</ul>
906906

907-
The values of the declarations that apply form,
907+
The values of the [=declarations=] that apply form,
908908
for each property on each element,
909909
a list of <a>declared values</a>.
910910
The next section,
@@ -928,19 +928,19 @@ Cascading</h2>
928928
The <dfn export>cascade</dfn>
929929
takes an unordered list of <a>declared values</a>
930930
for a given property on a given element,
931-
sorts them by their declaration’s precedence as determined below,
931+
sorts them by their [=declaration’s=] precedence as determined below,
932932
and outputs a single <a>cascaded value</a>.
933933

934934
<h3 id="cascade-sort">
935935
Cascade Sorting Order</h3>
936936

937-
The cascade sorts declarations according to the following criteria,
937+
The cascade sorts [=declarations=] according to the following criteria,
938938
in descending order of precedence:
939939

940940
<dl>
941941
<dt id='cascade-origin'>Origin and Importance
942942
<dd>
943-
The <a>origin</a> of a declaration is based on where it comes from
943+
The <a>origin</a> of a [=declaration=] is based on where it comes from
944944
and its <a lt="important">importance</a> is
945945
whether or not it is declared with ''!important''
946946
(see [[#importance|below]]).
@@ -961,7 +961,7 @@ Cascade Sorting Order</h3>
961961

962962
<dt id='cascade-context'>Context
963963
<dd>
964-
A document language can provide for blending declarations sourced
964+
A document language can provide for blending [=declarations=] sourced
965965
from different <dfn local-lt="context">encapsulation contexts</dfn>,
966966
such as the nested [=tree contexts=] of [=shadow trees=] in the [[!DOM]].
967967

@@ -1063,10 +1063,10 @@ Important Declarations: the ''!important'' annotation</h3>
10631063
CSS attempts to create a balance of power between author and user style sheets.
10641064
By default, rules in an author's style sheet override those in a user's style sheet,
10651065
which override those in the user-agent's default style sheet.
1066-
To balance this, a declaration can be marked [=important=],
1066+
To balance this, a [=declaration=] can be marked [=important=],
10671067
which increases its weight in the cascade and inverts the order of precedence.
10681068

1069-
A declaration is <dfn export local-lt="importance">important</dfn>
1069+
A [=declaration=] is <dfn export local-lt="importance">important</dfn>
10701070
if it has a ''!important'' annotation as defined by [[css-syntax-3]],
10711071
i.e. if the last two (non-whitespace, non-comment) tokens
10721072
in its value are the delimiter token ''!'' followed by the identifier token ''important''.
@@ -1259,7 +1259,7 @@ Rolling Back Cascade Origins: the ''revert'' keyword</h4>
12591259

12601260
If the <a>cascaded value</a> of a property is
12611261
the <dfn value for=all caniuse="css-revert-value">revert</dfn> keyword,
1262-
the behavior depends on the [=cascade origin=] to which the declaration belongs:
1262+
the behavior depends on the [=cascade origin=] to which the [=declaration=] belongs:
12631263

12641264
<dl>
12651265
<dt>[=user-agent origin=]

0 commit comments

Comments
 (0)