Skip to content

Commit e36a910

Browse files
committed
ok lets try some more bikeshed syntax for property descriptor disambiguation
1 parent f36dbca commit e36a910

1 file changed

Lines changed: 23 additions & 19 deletions

File tree

css-fonts-4/Overview.bs

Lines changed: 23 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -933,7 +933,7 @@ Shorthand font property: the 'font' property</h3>
933933

934934
<pre class="propdef">
935935
Name: font
936-
Value: [ [ <<'font-style'>> || <<font-variant-css21>> || <<'font-weight'>> || <<font-stretch-css3>> ]? <<'font-size'>> [ / <<'line-height'>> ]? <<'font-family'>> ] | caption | icon | menu | message-box | small-caption | status-bar
936+
Value: [ [ <<'font-style'>> || <<font-variant-css21>> || <<'font-weight'>> || <<font-stretch-css3>> ]? <<'font-size'>> [ / <<'line-height'>> ]? <<'font-family!!property'>> ] | caption | icon | menu | message-box | small-caption | status-bar
937937
Initial: see individual properties
938938
Applies to: all elements
939939
Inherited: yes
@@ -946,7 +946,7 @@ Animatable: see individual properties
946946
The 'font' property is,
947947
except as described below,
948948
a shorthand property for setting
949-
'font-style', 'font-variant', 'font-weight', 'font-stretch', 'font-size', 'line-height', 'font-family'
949+
'font-style', 'font-variant', 'font-weight', 'font-stretch', 'font-size', 'line-height', 'font-family!!property'
950950
at the same place in the stylesheet.
951951
Values for the 'font-variant' property can also be included
952952
but only those supported in CSS 2.1;
@@ -988,26 +988,30 @@ shorthand property; instead, use the individual property.
988988
height percentage ("110%") refers to the font size of the element
989989
itself.
990990

991-
The first three rules do not specify the 'font-variant' and 'font-weight' explicitly, so these properties
991+
The first three rules do not specify the 'font-variant!!property' and
992+
'font-weight!!property' explicitly, so these properties
992993
receive their initial values (''font-variant/normal''). Notice that the font family
993994
name ''"new century schoolbook"'', which contains spaces, is enclosed in
994-
quotes. The fourth rule sets the 'font-weight' to ''bold'', the 'font-style' to ''italic'', and implicitly sets
995-
'font-variant' to ''font-variant/normal''.
995+
quotes. The fourth rule sets the 'font-weight!!property' to ''bold'',
996+
the 'font-style!!property' to ''italic'', and implicitly sets
997+
'font-varian!!propertyt' to ''font-variant/normal''.
996998

997-
The fifth rule sets the 'font-variant' (''small-caps''), the 'font-size' (120% of the
998-
parent's font size), the 'line-height' (120% of the font size) and the 'font-family'
999-
(''fantasy''). It follows that the keyword <css>normal</css> applies to the two
1000-
remaining properties: 'font-style' and 'font-weight'.
999+
The fifth rule sets the 'font-variant!!property' (''small-caps''), the 'font-size!!property' (120% of the
1000+
parent's font size), the 'line-height!!property' (120% of the font size) and the
1001+
'font-family!!property' (''fantasy''). It follows that the keyword <css>normal</css>
1002+
applies to the two remaining properties: 'font-style!!property' and 'font-weight!!property'.
10011003

1002-
The sixth rule sets the 'font-style', 'font-stretch', 'font-size', and 'font-family', the other font
1004+
The sixth rule sets the 'font-style!!property', 'font-stretch!!property',
1005+
'font-size!!property', and 'font-family!!property', the other font
10031006
properties being set to their initial values.
10041007

1005-
The seventh rule sets 'font-style' to ''oblique 25deg'', 'font-weight' to ''753'', and 'font-stretch' to ''condensed''.
1008+
The seventh rule sets 'font-style!!property' to ''oblique 25deg'',
1009+
'font-weight!!property' to ''753'', and 'font-stretch!!property' to ''condensed''.
10061010
Note that the ''25deg'' in this rule must be immediately following the "oblique" keyword.
10071011
</div>
10081012

1009-
Since the 'font-stretch' property was not defined in CSS 2.1,
1010-
when using 'font-stretch' values within 'font' rules,
1013+
Since the 'font-stretch!!property' property was not defined in CSS 2.1,
1014+
when using 'font-stretch!!property' values within 'font' rules,
10111015
authors should include a extra version compatible with older user agents:
10121016

10131017
<pre>
@@ -1047,10 +1051,10 @@ should be set to their initial values.
10471051

10481052
That is why this property is "almost" a shorthand property: system
10491053
fonts can only be specified with this property, not with
1050-
'font-family' itself, so 'font'
1054+
'font-family!!property' itself, so 'font!!property'
10511055
allows authors to do more than the
10521056
sum of its subproperties. However, the individual properties such as
1053-
'font-weight' are still given values
1057+
'font-weight!!property' are still given values
10541058
taken from the system font, which can be independently varied.
10551059

10561060
Note that the keywords used for the system fonts listed above are
@@ -1078,7 +1082,7 @@ name:
10781082

10791083
<pre>button p { font: 600 9pt Charcoal }</pre>
10801084

1081-
Because the 'font' shorthand resets to its initial value
1085+
Because the 'font!!property' shorthand resets to its initial value
10821086
any property not explicitly given a value, this has the same effect as
10831087
this declaration:
10841088

@@ -2321,7 +2325,7 @@ if all font style properties were set to their initial value.
23212325
<ol id="fontmatchingalg">
23222326
1. Using the computed font property values for a given element,
23232327
the user agent starts with the first family name
2324-
specified by the 'font-family' property.
2328+
specified by the 'font-family!!property' property.
23252329

23262330
2. If the family name is a generic family keyword, the user agent
23272331
looks up the appropriate font family name to be used. User
@@ -2620,7 +2624,7 @@ used for example in the definition of <a>font-relative lengths</a> such as ''ex'
26202624
or in the definition of the 'line-height' property
26212625
is defined to be the first available font
26222626
that would match the U+0020 (space) character
2623-
given font families in the 'font-family' list
2627+
given font families in the 'font-family!!property' list
26242628
(or a user agent's default font if none are available).
26252629

26262630
<h3 id="cluster-matching">
@@ -3329,7 +3333,7 @@ Initial: N/A
33293333
This descriptor defines the font family name that this palette applies to.
33303334
This palette will only ever be applied to the font with this name.
33313335
The value of this descriptor matches the definition of the <<family-name>>
3332-
for the 'font-family' property.
3336+
for the 'font-family!!property' property.
33333337
This means that only named font families are allowed
33343338
and rules that including generic or installed fonts in the list of font families
33353339
are syntax errors.

0 commit comments

Comments
 (0)