Skip to content

Commit 0c7d3bc

Browse files
committed
[fonts-4] Redefine @font-face with a Syntax grammar, and rewrap surrounding paragraphs.
1 parent 4560a5d commit 0c7d3bc

File tree

1 file changed

+32
-45
lines changed

1 file changed

+32
-45
lines changed

css-fonts-4/Overview.bs

+32-45
Original file line numberDiff line numberDiff line change
@@ -1220,54 +1220,41 @@ Font Resources</h2>
12201220
<h3 id="font-face-rule">
12211221
The <dfn id="at-font-face-rule">''@font-face''</dfn> rule</h3>
12221222

1223-
The ''@font-face'' rule allows for linking to fonts that are
1224-
automatically fetched and activated when needed. This allows authors to select
1225-
a font that closely matches the design goals for a given page
1226-
rather than limiting the font choice to a set of fonts available
1227-
on a given platform. A set of font descriptors define the location of a font
1228-
resource, either locally or externally, along with the style characteristics of
1229-
an individual face. Multiple ''@font-face'' rules can be used to construct
1230-
font families with a variety of faces. Using CSS font matching rules, a
1231-
user agent can selectively download only those faces that are needed for
1232-
a given piece of text.
1233-
1234-
The ''@font-face'' rule consists of the ''@font-face'' at-keyword followed
1235-
by a block of descriptor declarations. In terms of the grammar, this
1236-
specification defines the following productions:
1223+
The ''@font-face'' rule allows for linking to fonts
1224+
that are automatically fetched and activated when needed.
1225+
This allows authors to select a font
1226+
that closely matches the design goals for a given page
1227+
rather than limiting the font choice
1228+
to a set of fonts available on a given platform.
1229+
A set of font descriptors define the location of a font resource,
1230+
either locally or externally,
1231+
along with the style characteristics of an individual face.
1232+
Multiple ''@font-face'' rules can be used to construct font families with a variety of faces.
1233+
Using CSS font matching rules,
1234+
a user agent can selectively download
1235+
only those faces that are needed for a given piece of text.
1236+
1237+
It's syntax is:
12371238

1238-
<pre>
1239-
<dfn>font_face_rule</dfn>
1240-
: <a>FONT_FACE_SYM</a> <a href="https://www.w3.org/TR/CSS21/grammar.html#scanner"><a>S</a></a>* '{' <a href="https://www.w3.org/TR/CSS21/grammar.html#scanner"><a>S</a></a>* <a>descriptor_declaration</a>? [ ';' <a href="https://www.w3.org/TR/CSS21/grammar.html#scanner"><a>S</a></a>* <a>descriptor_declaration</a>? ]* '}' <a href="https://www.w3.org/TR/CSS21/grammar.html#scanner"><a>S</a></a>*
1241-
;
1242-
1243-
<dfn>descriptor_declaration</dfn>
1244-
: <a href="https://www.w3.org/TR/CSS21/grammar.html#grammar"><a>property</a></a> ':' <a href="https://www.w3.org/TR/CSS21/grammar.html#scanner"><a>S</a></a>* <a href="https://www.w3.org/TR/CSS21/grammar.html#grammar"><a>expr</a></a>
1245-
;
1246-
</pre>
1247-
1248-
The following new definitions are introduced:
1249-
1250-
<pre>
1251-
- -|\\0{0,4}2d(\r\n|[ \t\r\n\f])?
1252-
1253-
F f|\\0{0,4}(46|66)(\r\n|[ \t\r\n\f])?
1239+
<pre class=prod>
1240+
@font-face {
1241+
<<declaration-list>>
1242+
}
12541243
</pre>
12551244

1256-
The following new token is introduced:
1257-
1258-
<pre>@{F}{O}{N}{T}{-}{F}{A}{C}{E} {return <dfn>FONT_FACE_SYM</dfn>;}</pre>
1245+
The ''@font-face'' rule accepts the descriptors defined in this specification.
12591246

1260-
Each ''@font-face''
1261-
rule specifies a value for every font descriptor, either implicitly or
1262-
explicitly. Those not given explicit values in the rule take the initial
1263-
value listed with each descriptor in this specification. These
1264-
descriptors apply solely within the context of the ''@font-face'' rule in
1265-
which they are defined, and do not apply to document language elements.
1266-
There is no notion of which elements the descriptors apply to or whether
1267-
the values are inherited by child elements. When a given descriptor occurs
1268-
multiple times in a given ''@font-face'' rule, only the last
1269-
descriptor declaration is used and all prior declarations for that
1270-
descriptor are ignored.
1247+
Each ''@font-face''rule specifies a value for every font descriptor,
1248+
either implicitly or explicitly.
1249+
Those not given explicit values in the rule
1250+
take the initial value listed with each descriptor in this specification.
1251+
These descriptors apply solely within the context of the ''@font-face'' rule in which they are defined,
1252+
and do not apply to document language elements.
1253+
There is no notion of which elements the descriptors apply to
1254+
or whether the values are inherited by child elements.
1255+
When a given descriptor occurs multiple times in a given ''@font-face'' rule,
1256+
only the last descriptor declaration is used
1257+
and all prior declarations for that descriptor are ignored.
12711258

12721259
<div class="example">
12731260
To use a downloadable font called Gentium:
@@ -2727,7 +2714,7 @@ followed by a block of descriptor declarations.
27272714
It has the following syntax:
27282715

27292716
<pre class=prod>
2730-
@font-palette-values {
2717+
@font-palette-values <<custom-ident>> {
27312718
<<declaration-list>>
27322719
}
27332720
</pre>

0 commit comments

Comments
 (0)