Skip to content

Commit 95ff9f3

Browse files
committed
Remove box-shadow for discussion so the rest of the draft can progress to CR. We can add it back once it's ready, or shift it into another module.
1 parent 4e4367f commit 95ff9f3

2 files changed

Lines changed: 29 additions & 523 deletions

File tree

css3-background/Overview.html

Lines changed: 20 additions & 295 deletions
Original file line numberDiff line numberDiff line change
@@ -137,10 +137,9 @@ <h2 class="no-num no-toc" id=status>Status of this document</h2>
137137
indicate an error in one or both specs.</strong>
138138

139139
<p>The following features are at-risk and may be dropped at the end of the
140-
CR period if there has not been enough interest from implementors: inner
141-
shadows for &lsquo;<code class=property><a
142-
href="#box-shadow">box-shadow</a></code>&rsquo;, &lsquo;<code
143-
class=property><a href="#box-break">box-break</a></code>&rsquo;.
140+
CR period if there has not been enough interest from implementors:
141+
&lsquo;<code class=property><a
142+
href="#box-break">box-break</a></code>&rsquo;.
144143

145144
<h2 class="no-num no-toc" id=contents>Table of contents</h2>
146145
<!--begin-toc-->
@@ -309,9 +308,9 @@ <h2 id=introduction><span class=secno>1 </span>Introduction</h2>
309308

310309
<p>The properties of this module deal with the decoration of the border
311310
area and with the background of the content, padding and border areas.
312-
Additionally the box may be given a "drop-shadow" effect with the
313-
&lsquo;<code class=property><a
314-
href="#box-shadow">box-shadow</a></code>&rsquo; property.
311+
<!-- Additionally the box may be given a "drop-shadow" effect with the
312+
'box-shadow' property. -->
313+
315314

316315
<p>If an element is broken into multiple boxes, &lsquo;<code
317316
class=property><a href="#box-break">box-break</a></code>&rsquo; defines
@@ -3410,19 +3409,19 @@ <h3 id=the-box-break><span class=secno>6.1 </span>The &lsquo;<code
34103409

34113410
<dd>Each box is independently wrapped with the border and padding. The
34123411
&lsquo;<code class=property><a
3413-
href="#border-radius">border-radius</a></code>&rsquo;, &lsquo;<code
3414-
class=property><a href="#border-image">border-image</a></code>&rsquo;,
3415-
and &lsquo;<code class=property><a
3416-
href="#box-shadow">box-shadow</a></code>&rsquo;, if any, are applied to
3417-
each box independently. The background is drawn independently in each box
3418-
of the element. A no-repeat background image will thus be rendered once
3419-
in each box of the element.
3412+
href="#border-radius">border-radius</a></code>&rsquo; and &lsquo;<code
3413+
class=property><a href="#border-image">border-image</a></code>&rsquo;
3414+
<!--, and 'box-shadow', if any, --> are applied to each box
3415+
independently. The background is drawn independently in each box of the
3416+
element. A no-repeat background image will thus be rendered once in each
3417+
box of the element.
34203418

34213419
<dt><dfn id=continous>continous</dfn>
34223420

34233421
<dd>
3424-
<p>No border and no padding are inserted at the break. No box-shadow is
3425-
drawn at the broken edge; &lsquo;<code class=property><a
3422+
<p>No border and no padding are inserted at the break. <!-- No box-shadow
3423+
is drawn at the broken edge; -->
3424+
&lsquo;<code class=property><a
34263425
href="#border-radius">border-radius</a></code>&rsquo; has no effect at
34273426
its corners; and the &lsquo;<code class=property><a
34283427
href="#border-image">border-image</a></code>&rsquo; is rendered for the
@@ -3475,265 +3474,12 @@ <h3 id=the-box-break><span class=secno>6.1 </span>The &lsquo;<code
34753474
class=css>direction: ltr</code>&rsquo; will break on the left side.
34763475

34773476
<h3 id=the-box-shadow><span class=secno>6.2 </span>The &lsquo;<code
3478-
class=property><a href="#box-shadow">box-shadow</a></code>&rsquo; property</h3>
3479-
3480-
<table class=propdef>
3481-
<tbody>
3482-
<tr>
3483-
<th>Name:
3484-
3485-
<td><dfn id=box-shadow>box-shadow</dfn>
3486-
3487-
<tr>
3488-
<th>Value:
3489-
3490-
<td>none | <var><a href="#ltshadowgt">&lt;shadow&gt;</a></var> [ ,
3491-
<var><a href="#ltshadowgt">&lt;shadow&gt;</a></var> ]*
3492-
3493-
<tr>
3494-
<th>Initial:
3495-
3496-
<td>none
3497-
3498-
<tr>
3499-
<th>Applies to:
3477+
class=property>box-shadow</code>&rsquo; property</h3>
35003478

3501-
<td>all elements
3502-
3503-
<tr>
3504-
<th>Inherited:
3505-
3506-
<td>no
3507-
3508-
<tr>
3509-
<th>Percentages:
3510-
3511-
<td>N/A
3512-
3513-
<tr>
3514-
<th>Media:
3515-
3516-
<td>visual
3517-
3518-
<tr>
3519-
<th>Computed value:
3520-
3521-
<td>any &lt;length&gt; made absolute; any color computed; otherwise as
3522-
specified
3523-
</table>
3524-
3525-
<p>The &lsquo;<code class=property><a
3526-
href="#box-shadow">box-shadow</a></code>&rsquo; property attaches one or
3527-
more drop-shadows to the box. The property is a comma-separated list of
3528-
shadows, each specified by 2-4 length values, an optional color, and an
3529-
optional &lsquo;<code class=css><a href="#inset">inset</a></code>&rsquo;
3530-
keyword. Omitted lengths are 0, omitted colors are a UA-chosen color.
3531-
3532-
<p>Where
3533-
3534-
<pre class=prod>
3535-
<dfn id=ltshadowgt><var>&lt;shadow&gt;</var></dfn> = inset? &amp;&amp; [ <var>&lt;length&gt;</var>{2,4} &amp;&amp; <var><a href="#ltcolorgt">&lt;color&gt;</a></var>? ]</pre>
3536-
3537-
<p>The components of each <var><a
3538-
href="#ltshadowgt">&lt;shadow&gt;</a></var> are interpreted as follows:
3539-
3540-
<ul>
3541-
<li>The first length is the horizontal offset of the shadow. A positive
3542-
value draws a shadow that is offset to the right of the box, a negative
3543-
length to the left.
3544-
3545-
<li>The second length is the vertical offset. A positive value offsets the
3546-
shadow down, a negative one up.
3547-
3548-
<li>The third length is a blur radius. Negative values are not allowed. If
3549-
it is 0, the shadow is sharp, otherwise the larger the value, the more
3550-
the shadow is blurred. The exact algorithm is not specified.
3551-
3552-
<li>The fourth length is a spread radius. Positive values cause the shadow
3553-
to grow in all directions by the specified radius. Negative values cause
3554-
the shadow to shrink. The shadow should not change shape when a spread
3555-
radius is applied: sharp corners should remain sharp.
3556-
3557-
<li>The color is the color of the shadow.
3558-
3559-
<li>The &lsquo;<code class=css><a href="#inset">inset</a></code>&rsquo;
3560-
keyword, if present, changes the drop shadow from an outer shadow (one
3561-
that shadows the box onto the canvas, as if it were lifted above the
3562-
canvas) to an inner shadow (one that shadows the canvas onto the box, as
3563-
if the box were cut out of the canvas and shifted behind it).
3564-
</ul>
3565-
3566-
<p>An outer box-shadow casts a shadow as if the border-box of the element
3567-
were opaque. The shadow is drawn outside the border edge only: it is not
3568-
drawn inside the border-box of the element.
3569-
3570-
<p>An inner box-shadow casts a shadow as if everything outside the padding
3571-
edge were opaque. The inner shadow is drawn inside the padding edge only:
3572-
it is not drawn outside the padding box of the element.
3573-
3574-
<p>If the box has a nonzero <span class=property>&lsquo;<code
3575-
class=property><a
3576-
href="#border-radius">border-radius</a></code>&rsquo;</span>, the shadow
3577-
is rounded in the same way.
3578-
3579-
<div class=issue>
3580-
<p><strong>This is still <a
3581-
href="http://lists.w3.org/Archives/Public/www-style/2009Jul/0120.html">under
3582-
discussion</a>. Please send comments to www-style.</strong></p>
3583-
3584-
<p>However, if the box has a border-image, the shadows drawn differently:
3585-
they are masked by the border-image instead of the border area as
3586-
follows.
3587-
3588-
<ul>
3589-
<li>For an outer shadow, the shadow is created by assuming that the
3590-
padding box is opaque, and then combining that with the border-image to
3591-
create an alpha-channel mask for the shadow. Spread values are
3592-
interpreted as increasing the size of the padding box and causing the
3593-
border-image mask to be resized accordingly. The resulting shadow is
3594-
only drawn outside the boundaries of the padding box.
3595-
3596-
<li>For an inner shadow, the shadow is created by assuming that
3597-
everything outside the border box is opaque, and then combining that
3598-
with the border-image to create an alpha-channel mask for the shadow.
3599-
Spread values are interpreted as decreasing the size of the border box
3600-
and causing the border-image mask to be resized accordingly. The
3601-
resulting shadow is only drawn inside the boundaries of the border box.
3602-
</ul>
3603-
3604-
<p>If the UA is unable to create shadows that respect the transparent and
3605-
partially-transparent aspects of the border-image, it must not create a
3606-
shadow at all. The UA <em>may</em> ignore spread values when drawing
3607-
shadows for a border-image.</p>
3608-
</div>
3609-
3610-
<p>If an element has multiple boxes, all of them get drop shadows, but
3611-
shadows are only drawn where borders would also be drawn, see &lsquo;<code
3612-
class=property><a href="#box-break">box-break</a></code>&rsquo;.
3613-
3614-
<p>The shadow effects are applied front-to-back: the first shadow is on top
3615-
and the others are layered behind. Shadows do not influence layout and may
3616-
overlap other boxes or their shadows. In terms of stacking contexts and
3617-
the painting order, the outer shadows of an element are drawn immediately
3618-
below the background of that element, and the inner shadows of an element
3619-
are drawn immediately above the background of that element (below the
3620-
borders and border image, if any).
3621-
3622-
<p>Shadows never affect layout, and do not trigger scrolling or increase
3623-
the size of the scrollable area.
3624-
3625-
<div class=example>
3626-
<p>Below are some examples of an orange box with a blue border being being
3627-
given a drop shadow.</p>
3628-
3629-
<table class=data id=box-shadow-samples>
3630-
<tbody>
3631-
<tr>
3632-
<th scope=rowgroup>
3633-
<pre><code><!--
3634-
-->border:5px solid blue;
3635-
<!-- -->background-color:orange;
3636-
<!-- -->width: 144px;
3637-
<!-- -->height: 144px;<!--
3638-
--></code></pre>
3639-
3640-
<th>
3641-
<pre><code>border-radius: 20px;</code></pre>
3642-
3643-
<th>
3644-
<pre><code>border-radius: 0;</code></pre>
3645-
3646-
<tr>
3647-
<th>
3648-
<pre><code><!--
3649-
-->box-shadow:
3650-
<!-- --> rgba(0,0,0,0.4)
3651-
<!-- --> 10px 10px;<!--
3652-
--></code></pre>
3653-
3654-
<td> <img alt="A round-cornered box with a light gray shadow the same
3655-
shape as the border box offset 10px to the right and 10px down from
3656-
directly underneath the box." height=175 src=shadow-outer-round.png
3657-
width=175>
3658-
3659-
<td> <img alt="A square-cornered box with a light gray shadow the same
3660-
shape as the border box offset 10px to the right and 10px down from
3661-
directly underneath the box." height=175 src=shadow-outer-square.png
3662-
width=175>
3663-
3664-
<tr>
3665-
<th>
3666-
<pre><code><!--
3667-
-->box-shadow:
3668-
<!-- --> rgba(0,0,0,0.4)
3669-
<!-- --> 10px 10px
3670-
<!-- --> inset<!--
3671-
--></code></pre>
3672-
3673-
<td> <img alt="A round-cornered box with a light gray shadow the
3674-
inverse shape of the padding box filling 10px in from the top and left
3675-
edges (just inside the border)." height=175 src=shadow-inner-round.png
3676-
width=175>
3677-
3678-
<td> <img alt="A square-cornered box with a light gray shadow the
3679-
inverse shape of the padding box filling 10px in from the top and left
3680-
edges (just inside the border)." height=175
3681-
src=shadow-inner-square.png width=175>
3682-
3683-
<tr>
3684-
<th>
3685-
<pre><code><!--
3686-
-->box-shadow:
3687-
<!-- --> rgba(0,0,0,0.4)
3688-
<!-- --> 10px 10px 0
3689-
<!-- --> 10px /* spread */<!--
3690-
--></code></pre>
3691-
3692-
<td> <img alt="A round-cornered box with a light gray shadow the same
3693-
shape as the box but 20px taller and wider and offset so that the top
3694-
and left edges of the shadow are directly underneath the top and left
3695-
edges of the box." height=175 src=shadow-outer-spread-round.png
3696-
width=175>
3697-
3698-
<td> <img alt="A square-cornered box with a light gray shadow the same
3699-
shape as the box but 20px taller and wider and offset so that the top
3700-
and left edges of the shadow are directly underneath the top and left
3701-
edges of the box." height=175 src=shadow-outer-spread-square.png
3702-
width=175>
3703-
3704-
<tr>
3705-
<th>
3706-
<pre><code><!--
3707-
-->box-shadow:
3708-
<!-- --> rgba(0,0,0,0.4)
3709-
<!-- --> 10px 10px 0
3710-
<!-- --> 10px /* spread */
3711-
<!-- --> inset<!--
3712-
--></code></pre>
3713-
3714-
<td> <img alt="A round-cornered box with a light gray shadow the
3715-
inverse shape of the box but 20px narrower and shorter filling 20px in
3716-
from the top and left edges (just inside the border)." height=175
3717-
src=shadow-inner-spread-round.png width=175>
3718-
3719-
<td> <img alt="A round-cornered box with a light gray shadow the
3720-
inverse shape of the box but 20px narrower and shorter filling 20px in
3721-
from the top and left edges (just inside the border)." height=175
3722-
src=shadow-inner-spread-square.png width=175>
3723-
</table>
3724-
</div>
3725-
3726-
<p>The &lsquo;<code class=css><a
3727-
href="#box-shadow">box-shadow</a></code>&rsquo; property applies to the
3728-
&lsquo;<code class=css>::first-letter</code>&rsquo; pseudo-element, but
3729-
not the &lsquo;<code class=css>::first-line</code>&rsquo; pseudo-element.
3730-
Outer shadows have no effect on internal table elements in the collapsing
3731-
border model. If a shadow is defined for single border edge in the
3732-
collapsing border model has multiple border thicknesses (e.g. an outer
3733-
shadow on a table where one row has thicker borders than the others, or an
3734-
inner shadow on a rowspanning table cell that adjoins cells with different
3735-
border thicknesses), the exact position and rendering of its shadows are
3736-
undefined.
3479+
<p class=note>This module previously defined a &lsquo;<code
3480+
class=property>box-shadow</code>&rsquo; property. This feature has been
3481+
removed from this module for further discussion, and should reappear in
3482+
another CSS module in the future.
37373483

37383484
<h2 id=definitions><span class=secno>7 </span>Definitions</h2>
37393485

@@ -4610,21 +4356,6 @@ <h2 class=no-num id=property-index>Property index</h2>
46104356

46114357
<td>N/A
46124358

4613-
<td>visual
4614-
4615-
<tr valign=baseline>
4616-
<td><a class=property href="#box-shadow">box-shadow</a>
4617-
4618-
<td>none | &lt;shadow&gt; [ , &lt;shadow&gt; ]*
4619-
4620-
<td>none
4621-
4622-
<td>all elements
4623-
4624-
<td>no
4625-
4626-
<td>N/A
4627-
46284359
<td>visual
46294360
</table>
46304361
<!--end-properties-->
@@ -4812,9 +4543,6 @@ <h2 class=no-num id=index>Index</h2>
48124543
<li>box-break, <a href="#box-break"
48134544
title=box-break><strong>6.1</strong></a>
48144545

4815-
<li>box-shadow, <a href="#box-shadow"
4816-
title=box-shadow><strong>6.2</strong></a>
4817-
48184546
<li>center, <a href="#position-center"
48194547
title=center><strong>3.6</strong></a>
48204548

@@ -4903,9 +4631,6 @@ <h2 class=no-num id=index>Index</h2>
49034631
title=round><strong>3.4</strong></a>, <a href="#round-round"
49044632
title=round><strong>3.4</strong></a>
49054633

4906-
<li><var><a href="#ltshadowgt">&lt;shadow&gt;</a></var>, <a
4907-
href="#ltshadowgt" title="&lt;shadow&gt;"><strong>6.2</strong></a>
4908-
49094634
<li>solid, <a href="#solid" title=solid><strong>4.2</strong></a>
49104635

49114636
<li>space, <a href="#border-image-space"

0 commit comments

Comments
 (0)