Skip to content

Commit 25d907c

Browse files
committed
[css-syntax-3] Define at-rule and descriptor. w3c#5633
1 parent 631c44c commit 25d907c

1 file changed

Lines changed: 34 additions & 0 deletions

File tree

css-syntax-3/Overview.bs

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3361,6 +3361,40 @@ Style rules</h3>
33613361
For example, qualified rules inside ''@media'' rules [[CSS3-CONDITIONAL]] are style rules,
33623362
but qualified rules inside ''@keyframes'' rules are not [[CSS3-ANIMATIONS]].
33633363

3364+
<h3 id="at-rules">
3365+
At-rules</h3>
3366+
3367+
An <dfn export>at-rule</dfn> is a rule that begins with an at-keyword,
3368+
and can thus be distinguished from [=style rules=] in the same context.
3369+
3370+
[=At-rules=] are used to:
3371+
3372+
* group and structure style rules and other at-rules
3373+
such as in [=conditional rules=]
3374+
* declare style information that is not associated with a particular element,
3375+
such as defining [=counter styles=]
3376+
* manage syntactic constructs
3377+
such as [=imports=] and [=namespace=] keyword mappings
3378+
* and serve other miscellaneous purposes not served by a [=style rule=]
3379+
3380+
At-rules take many forms, depending on the specific rule and its purpose,
3381+
but broadly speaking there are two kinds:
3382+
<dfn lt="statement at-rule" export>statement at-rules</dfn>
3383+
which are simpler constructs that end in a semicolon,
3384+
and <dfn lt="block at-rule" export>block at-rules</dfn>
3385+
which end in a [={}-block=]
3386+
that can contain nested [=rules=] or [=declarations=].
3387+
3388+
[=Block at-rules=] will typically contain a collection of
3389+
(generic or [=at-rule=]&ndash;specific)
3390+
[=at-rules=], [=qualified rules=], and/or [=descriptor declarations=]
3391+
subject to limitations defined by the [=at-rule=].
3392+
<dfn lt="descriptor" export for=CSS>Descriptors</dfn> are similar to [=properties=]
3393+
(and are declared with the same syntax)
3394+
but are associated with a particular type of [=at-rule=]
3395+
rather than with elements and boxes in the tree.
3396+
3397+
33643398
<h3 id='charset-rule'>
33653399
The ''@charset'' Rule</h3>
33663400

0 commit comments

Comments
 (0)