Skip to content

Commit a542e39

Browse files
SebastianZSebastianZ
committed
[css-conditional-3][editorial] Fixed Bikeshed issues
1 parent 97eaa5b commit a542e39

1 file changed

Lines changed: 116 additions & 113 deletions

File tree

‎css-conditional-3/Overview.bs‎

Lines changed: 116 additions & 113 deletions
Original file line numberDiff line numberDiff line change
@@ -32,12 +32,15 @@ Default Highlight: css
3232
</pre>
3333

3434
<pre class=link-defaults>
35+
spec:css-backgrounds-3; type:property;
36+
text:border
37+
text:box-shadow
3538
spec:css-color-4; type:property; text:color
36-
spec:html; type:element; text:link
37-
spec:css-namespaces-3; type:dfn; text:namespace prefix
38-
spec:css-namespaces-3; type:dfn; text:CSS qualified name
39-
spec:css-backgrounds-3; type:property; text:box-shadow
39+
spec:css-namespaces-3; type:dfn;
40+
text:namespace prefix
41+
text:CSS qualified name
4042
spec:css-syntax-3; type:type; text:<declaration>
43+
spec:html; type:element; text:link
4144
</pre>
4245

4346
<h2 id="introduction">Introduction</h2>
@@ -265,7 +268,7 @@ Its syntax is:
265268

266269
<pre class="prod def" nohighlight>
267270
@media <<media-query-list>> {
268-
<<rule-list>>
271+
<<rule-list>>
269272
}
270273
</pre>
271274

@@ -331,15 +334,15 @@ is similar to that defined for <<media-condition>> in [[MEDIAQUERIES-4]],
331334
but without the "unknown" value logic:
332335

333336
* negation is needed so that
334-
the new-feature styles and the fallback styles
335-
can be separated
336-
(within the forward-compatible grammar's rules for the syntax of @-rules),
337-
and not required to override each other.
337+
the new-feature styles and the fallback styles
338+
can be separated
339+
(within the forward-compatible grammar's rules for the syntax of @-rules),
340+
and not required to override each other.
338341
* conjunction (and) is needed so that
339-
multiple required features can be tested.
342+
multiple required features can be tested.
340343
* disjunction (or) is needed
341-
when there are multiple alternative features for a set of styles,
342-
particularly when some of those alternatives are vendor-prefixed properties or values.
344+
when there are multiple alternative features for a set of styles,
345+
particularly when some of those alternatives are vendor-prefixed properties or values.
343346

344347
Therefore, the syntax of the ''@supports'' rule allows
345348
testing for property:value pairs, and arbitrary conjunctions (and),
@@ -349,19 +352,19 @@ The syntax of the ''@supports'' rule is:
349352

350353
<pre class="prod def" nohighlight>
351354
@supports <<supports-condition>> {
352-
<<rule-list>>
355+
<<rule-list>>
353356
}
354357
</pre>
355358

356359
with <<supports-condition>> defined as:
357360

358361
<pre class="prod def" nohighlight>
359-
<dfn>&lt;supports-condition></dfn> = not <<supports-in-parens>>
360-
| <<supports-in-parens>> [ and <<supports-in-parens>> ]*
361-
| <<supports-in-parens>> [ or <<supports-in-parens>> ]*
362-
<dfn>&lt;supports-in-parens></dfn> = ( <<supports-condition>> ) | <<supports-feature>> | <<general-enclosed>>
363-
<dfn>&lt;supports-feature></dfn> = <<supports-decl>>
364-
<dfn>&lt;supports-decl></dfn> = ( <<declaration>> )
362+
<dfn>&lt;supports-condition></dfn> = not <<supports-in-parens>>
363+
| <<supports-in-parens>> [ and <<supports-in-parens>> ]*
364+
| <<supports-in-parens>> [ or <<supports-in-parens>> ]*
365+
<dfn>&lt;supports-in-parens></dfn> = ( <<supports-condition>> ) | <<supports-feature>> | <<general-enclosed>>
366+
<dfn>&lt;supports-feature></dfn> = <<supports-decl>>
367+
<dfn>&lt;supports-decl></dfn> = ( <<declaration>> )
365368
</pre>
366369

367370
The above grammar is purposely very loose for forwards-compatibility reasons,
@@ -407,106 +410,106 @@ as follows:
407410

408411
: not <<supports-in-parens>>
409412
:: The result is the negation of the <<supports-in-parens>> term.
410-
<wpt title="Not negates supports condition.">
411-
at-supports-009.html
412-
at-supports-010.html
413-
css-supports-016.xht
414-
</wpt>
415-
<wpt title="Not must be followed by space.">
416-
at-supports-014.html
417-
css-supports-038.xht
418-
</wpt>
419-
<wpt title="Not requires parentheses.">
420-
css-supports-017.xht
421-
css-supports-018.xht
422-
</wpt>
413+
<wpt title="Not negates supports condition.">
414+
at-supports-009.html
415+
at-supports-010.html
416+
css-supports-016.xht
417+
</wpt>
418+
<wpt title="Not must be followed by space.">
419+
at-supports-014.html
420+
css-supports-038.xht
421+
</wpt>
422+
<wpt title="Not requires parentheses.">
423+
css-supports-017.xht
424+
css-supports-018.xht
425+
</wpt>
423426

424427

425428
: <<supports-in-parens>> [ and <<supports-in-parens>> ]*
426429
::
427-
The result is true if all of the <<supports-in-parens>> child terms are true,
428-
and false otherwise.
429-
<wpt title="And condition is true iff all linked conditions are true.">
430-
at-supports-007.html
431-
at-supports-010.html
432-
at-supports-012.html
433-
css-supports-008.xht
434-
css-supports-009.xht
435-
css-supports-010.xht
436-
css-supports-012.xht
437-
</wpt>
438-
<wpt title="And requires parentheses.">
439-
css-supports-019.xht
440-
</wpt>
430+
The result is true if all of the <<supports-in-parens>> child terms are true,
431+
and false otherwise.
432+
<wpt title="And condition is true iff all linked conditions are true.">
433+
at-supports-007.html
434+
at-supports-010.html
435+
at-supports-012.html
436+
css-supports-008.xht
437+
css-supports-009.xht
438+
css-supports-010.xht
439+
css-supports-012.xht
440+
</wpt>
441+
<wpt title="And requires parentheses.">
442+
css-supports-019.xht
443+
</wpt>
441444

442445
: <<supports-in-parens>> [ or <<supports-in-parens>> ]*
443446
::
444-
The result is false if all of the <<supports-in-parens>> child terms are false,
445-
and true otherwise.
446-
<wpt title="Or condition is true iff any of linked conditions is true.">
447-
at-supports-008.html
448-
at-supports-010.html
449-
at-supports-013.html
450-
css-supports-006.xht
451-
css-supports-007.xht
452-
css-supports-011.xht
453-
css-supports-021.xht
454-
</wpt>
455-
<wpt title="Or must be followed by space.">
456-
at-supports-043.html
457-
css-supports-039.xht
458-
</wpt>
459-
<wpt title="Or requires parentheses.">
460-
css-supports-029.xht
461-
css-supports-030.xht
462-
</wpt>
447+
The result is false if all of the <<supports-in-parens>> child terms are false,
448+
and true otherwise.
449+
<wpt title="Or condition is true iff any of linked conditions is true.">
450+
at-supports-008.html
451+
at-supports-010.html
452+
at-supports-013.html
453+
css-supports-006.xht
454+
css-supports-007.xht
455+
css-supports-011.xht
456+
css-supports-021.xht
457+
</wpt>
458+
<wpt title="Or must be followed by space.">
459+
at-supports-043.html
460+
css-supports-039.xht
461+
</wpt>
462+
<wpt title="Or requires parentheses.">
463+
css-supports-029.xht
464+
css-supports-030.xht
465+
</wpt>
463466

464467
: <<supports-decl>>
465468
::
466-
The result is true if the UA [=supports=] the declaration within the parentheses.
467-
<wpt title="Supports condition is true iff declaration is supported.">
468-
at-supports-001.html
469-
at-supports-017.html
470-
at-supports-018.html
471-
css-supports-001.xht
472-
</wpt>
473-
<wpt title="Declaration cannot include semicolon.">
474-
at-supports-038.html
475-
at-supports-039.html
476-
</wpt>
477-
<wpt title="Declaration value can be empty.">
478-
css-supports-022.xht
479-
</wpt>
480-
<wpt title="Declaration cannot include invalid !tokens.">
481-
css-supports-043.xht
482-
css-supports-044.xht
483-
css-supports-045.xht
484-
</wpt>
469+
The result is true if the UA [=supports=] the declaration within the parentheses.
470+
<wpt title="Supports condition is true iff declaration is supported.">
471+
at-supports-001.html
472+
at-supports-017.html
473+
at-supports-018.html
474+
css-supports-001.xht
475+
</wpt>
476+
<wpt title="Declaration cannot include semicolon.">
477+
at-supports-038.html
478+
at-supports-039.html
479+
</wpt>
480+
<wpt title="Declaration value can be empty.">
481+
css-supports-022.xht
482+
</wpt>
483+
<wpt title="Declaration cannot include invalid !tokens.">
484+
css-supports-043.xht
485+
css-supports-044.xht
486+
css-supports-045.xht
487+
</wpt>
485488

486489
: <<general-enclosed>>
487490
::
488-
The result is false.
489-
490-
Authors must not use <<general-enclosed>> in their stylesheets.
491-
<span class='note'>It exists only for future-compatibility,
492-
so that new syntax additions do not invalidate too much of a <<supports-condition>> in older user agents.</span>
493-
<wpt title="Unrecognized but grammatically-valid condition is false, not invalid.">
494-
at-supports-015.html
495-
at-supports-046.html
496-
css-supports-023.xht
497-
css-supports-031.xht
498-
css-supports-032.xht
499-
css-supports-033.xht
500-
css-supports-034.xht
501-
css-supports-036.xht
502-
css-supports-040.xht
503-
css-supports-041.xht
504-
css-supports-042.xht
505-
css-supports-046.xht
506-
</wpt>
507-
<wpt title="Brackets/parenthesis must be balanced">
508-
css-supports-035.xht
509-
</wpt>
491+
The result is false.
492+
493+
Authors must not use <<general-enclosed>> in their stylesheets.
494+
<span class='note'>It exists only for future-compatibility,
495+
so that new syntax additions do not invalidate too much of a <<supports-condition>> in older user agents.</span>
496+
<wpt title="Unrecognized but grammatically-valid condition is false, not invalid.">
497+
at-supports-015.html
498+
at-supports-046.html
499+
css-supports-023.xht
500+
css-supports-031.xht
501+
css-supports-032.xht
502+
css-supports-033.xht
503+
css-supports-034.xht
504+
css-supports-036.xht
505+
css-supports-040.xht
506+
css-supports-041.xht
507+
css-supports-042.xht
508+
css-supports-046.xht
509+
</wpt>
510+
<wpt title="Brackets/parenthesis must be balanced">
511+
css-supports-035.xht
512+
</wpt>
510513

511514
The condition of the ''@supports'' rule
512515
is the result of the <<supports-condition>> in its prelude.
@@ -902,11 +905,11 @@ partial namespace CSS {
902905
</pre>
903906

904907
<dl class='idl-methods'>
905-
<dt><code>supports(CSSOMString property, CSSOMString value)</code>, returns <code>boolean</code>
906-
<dd>
908+
<dt><code>supports(CSSOMString property, CSSOMString value)</code>, returns <code>boolean</code>
909+
<dd>
907910
<div algorithm="supports(property, value)">
908-
When the {{supports(property, value)}} method is invoked
909-
with two arguments <var>property</var> and <var>value</var>:
911+
When the {{supports(property, value)}} method is invoked
912+
with two arguments <var>property</var> and <var>value</var>:
910913

911914
1. If |property| is an [=ASCII case-insensitive=] match
912915
for any defined CSS property that the UA supports,
@@ -926,10 +929,10 @@ partial namespace CSS {
926929

927930
<wpt title="CSS.supports(arg1, arg2) evaluates support of property arg1 with value arg2."></wpt>
928931

929-
<dt><code>supports(CSSOMString conditionText)</code>, returns <code>boolean</code>
930-
<dd>
932+
<dt><code>supports(CSSOMString conditionText)</code>, returns <code>boolean</code>
933+
<dd>
931934
<div algorithm="supports(conditionText)">
932-
When the {{supports(conditionText)}} method is invoked
935+
When the {{supports(conditionText)}} method is invoked
933936
with a single <var>conditionText</var> argument:
934937

935938
1. If |conditionText|,

0 commit comments

Comments
 (0)