Skip to content

Commit 825342e

Browse files
committed
[selectors4] Tweak invalid selectors section wording to add a <dfn> for Lacky
--HG-- extra : rebase_source : c7f8f8e0c5c55d1ac7cfaefbd1f18d34d1ab31ae
1 parent abd8829 commit 825342e

3 files changed

Lines changed: 50 additions & 30 deletions

File tree

css3-background/Overview.src.html

Lines changed: 31 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -2935,25 +2935,26 @@ <h3 id="the-box-shadow">Drop Shadows: the 'box-shadow' property</h3>
29352935
the shadow shape is rounded in the same way. The 'border-image' does not
29362936
affect the shape of the box-shadow.
29372937

2938-
<p>If a spread distance is defined, the shadow is expanded outward or
2939-
contracted inward by an operation equivalent to applying the
2940-
absolute value of the spread value to a blur operation as defined below
2938+
<p>If a spread distance is defined,
2939+
the shadow is expanded outward or contracted inward by an operation equivalent to
2940+
applying the absolute value of the spread value to a blur operation as defined below
29412941
and thresholding the result such that for a positive spread distance all
2942-
non-transparent pixels are given the full shadow color and for a
2943-
negative spread distance all non-opaque pixels are made transparent.
2944-
The UA may approximate this operation by taking an outward outset of the
2945-
specified amount normal to the original shadow perimeter. Alternatively
2946-
the UA may approximate the transformed shadow perimeter shape by
2947-
outsetting (insetting, for inner shadows) the shadow's straight edges
2942+
pixels within XXX are given the full shadow color
2943+
and for a negative spread distance they are made transparent.
2944+
The UA may approximate this operation by shifting each point of the shadow perimeter
2945+
outward by the spread distance in the direction normal to the original shadow perimeter.
2946+
Alternatively the UA may approximate the transformed shadow perimeter shape
2947+
by outsetting (insetting, for inner shadows) the shadow's straight edges
29482948
by the spread distance and increasing (decreasing, for inner shadows)
2949-
and flooring at zero the corner radii by the same amount. (The UA may
2950-
even combine these methods, using one method for outer shadows and
2951-
another for inner ones.)
2949+
and flooring at zero the corner radii by the same amount.
2950+
(The UA may even combine these methods, using one method for outer shadows
2951+
and another for inner ones.)
29522952
For corners with a zero border-radius, however, the corner must remain
29532953
sharp&#8212;the operation is equivalent to scaling the shadow shape.
2954-
In any case, the effective width and height of the shadow shape is
2955-
floored at zero. (A zero-sized shadow shape would cause an outer shadow
2956-
to disappear, and an inner shadow to cover the entire padding-box.)
2954+
In any case, the effective width and height of the shadowed shape
2955+
is floored at zero.
2956+
(A zero-sized shadowed shape would cause an outer shadow to disappear,
2957+
and an inner shadow to cover the entire padding-box.)
29572958

29582959
<p>A non-zero blur distance indicates that the resulting shadow should
29592960
be blurred, such as by a Gaussian filter. The exact algorithm is not
@@ -3297,6 +3298,21 @@ <h3 id="exit">
32973298
<h2 id="changes">
32983299
Changes</h2>
32993300

3301+
<h3 id="changes-2012">
3302+
Changes since the 24 July 2012 Candidate Recommendation</h3>
3303+
3304+
<p>The following (non-editorial) changes were made to this specification since the
3305+
<a href="http://www.w3.org/TR/2012/CR-css3-background-20120724/">24 July 2012 Candidate Recommendation</a>:
3306+
3307+
<ul>
3308+
<li>Allow <var>&lt;color></var> and ''inset'' to be interleaved in any order in 'box-shadow',
3309+
since they are not ambiguous and CSS generally allows variant ordering where not ambiguous.
3310+
<li>Allow <var>&lt;'background-clip'></var> and <var>&lt;'background-origin'></var>
3311+
to be separated by other component values in the 'background' shorthand,
3312+
since this is what is implemented.
3313+
<li>Clarify the definition of the spread for 'box-shadow'.
3314+
</ul>
3315+
33003316
<h3 id="changes-2012">
33013317
Changes since the 17 April 2012 Candidate Recommendation</h3>
33023318

selectors4/Overview.html

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -9,10 +9,10 @@
99
rel=dcterms.rights>
1010
<meta content="Selectors Level 4" name=dcterms.title>
1111
<meta content=text name=dcterms.type>
12-
<meta content=2012-11-19 name=dcterms.issued>
12+
<meta content=2012-11-27 name=dcterms.issued>
1313
<meta content="http://dev.w3.org/csswg/selectors4/" name=dcterms.creator>
1414
<meta content=W3C name=dcterms.publisher>
15-
<meta content="http://www.w3.org/TR/2012/ED-selectors4-20121119/"
15+
<meta content="http://www.w3.org/TR/2012/ED-selectors4-20121127/"
1616
name=dcterms.identifier>
1717
<link href="../default.css" rel=stylesheet type="text/css">
1818
<style type="text/css">
@@ -29,14 +29,14 @@
2929

3030
<h1 id=title>Selectors Level 4</h1>
3131

32-
<h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 19 November
32+
<h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 27 November
3333
2012</h2>
3434

3535
<dl>
3636
<dt>This version:
3737

38-
<dd><a href="http://www.w3.org/TR/2012/ED-selectors4-20121119/">
39-
http://www.w3.org/TR/2012/ED-selectors4-20121119/</a>
38+
<dd><a href="http://www.w3.org/TR/2012/ED-selectors4-20121127/">
39+
http://www.w3.org/TR/2012/ED-selectors4-20121127/</a>
4040

4141
<dt>Editor's draft:
4242

@@ -1421,12 +1421,15 @@ <h3 id=namespaces><span class=secno>3.7. </span> Namespaces</h3>
14211421
<h3 id=invalid><span class=secno>3.8. </span> Invalid Selectors and Error
14221422
Handling</h3>
14231423

1424-
<p>Invalidity is caused by a parsing error, e.g. an unrecognized token or a
1425-
token which is not allowed at the current parsing point.
1426-
1427-
<p>User agents must observe the rules for handling parsing errors:
1424+
<p>User agents must observe the rules for handling <dfn
1425+
id=invalid-selectors title="invalid selector|invalid">invalid
1426+
selectors</dfn>:
14281427

14291428
<ul>
1429+
<li>a parsing error in a selector, e.g. an unrecognized token or a token
1430+
which is not allowed at the current parsing point, causes that selector
1431+
to be invalid
1432+
14301433
<li>a simple selector containing an <a href="#namespaces">undeclared
14311434
namespace prefix</a> is invalid
14321435

@@ -1436,7 +1439,8 @@ <h3 id=invalid><span class=secno>3.8. </span> Invalid Selectors and Error
14361439
<li>a selector list containing an invalid selector is invalid.
14371440
</ul>
14381441

1439-
<p>An invalid selector represents nothing.
1442+
<p>An <a href="#invalid-selectors"><i>invalid selector</i></a> represents
1443+
nothing.
14401444

14411445
<p class=issue>It's been <a
14421446
href="http://lists.w3.org/Archives/Public/www-style/2010Nov/0203.html">requested</a>

selectors4/Overview.src.html

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -759,18 +759,18 @@ <h3 id="namespaces">
759759
<h3 id="invalid">
760760
Invalid Selectors and Error Handling</h3>
761761

762-
<p>Invalidity is caused by a parsing error, e.g. an unrecognized token or a token
763-
which is not allowed at the current parsing point.
764-
765-
<p>User agents must observe the rules for handling parsing errors:
762+
<p>User agents must observe the rules for handling <dfn title="invalid selector|invalid">invalid selectors</dfn>:
766763
<ul>
764+
<li>a parsing error in a selector,
765+
e.g. an unrecognized token or a token which is not allowed at the current parsing point,
766+
causes that selector to be invalid
767767
<li>a simple selector containing an <a href="#namespaces">undeclared namespace prefix</a> is invalid
768768
<li>a selector containing an invalid simple selector, an invalid combinator
769769
or an invalid token is invalid.
770770
<li>a selector list containing an invalid selector is invalid.
771771
</ul>
772772

773-
<p>An invalid selector represents nothing.
773+
<p>An <i>invalid selector</i> represents nothing.
774774

775775
<p class="issue">It's been <a href="http://lists.w3.org/Archives/Public/www-style/2010Nov/0203.html">requested</a>
776776
that the last rule be dropped in favor of Media Queries-style error-handling.

0 commit comments

Comments
 (0)