@@ -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 ‘< code class =property > < a
142- href ="#box-shadow "> box-shadow</ a > </ code > ’, ‘< code
143- class =property > < a href ="#box-break "> box-break</ a > </ code > ’.
140+ CR period if there has not been enough interest from implementors:
141+ ‘< code class =property > < a
142+ href ="#box-break "> box-break</ a > </ code > ’.
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- ‘ < code class = property > < a
314- href =" #box-shadow " > box-shadow </ a > </ code > ’ 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, ‘< code
317316 class =property > < a href ="#box-break "> box-break</ a > </ code > ’ defines
@@ -3410,19 +3409,19 @@ <h3 id=the-box-break><span class=secno>6.1 </span>The ‘<code
34103409
34113410 < dd > Each box is independently wrapped with the border and padding. The
34123411 ‘< code class =property > < a
3413- href ="#border-radius "> border-radius</ a > </ code > ’, ‘< code
3414- class =property > < a href ="#border-image "> border-image</ a > </ code > ’,
3415- and ‘< code class =property > < a
3416- href ="#box-shadow "> box-shadow</ a > </ code > ’, 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 > ’ and ‘< code
3413+ class =property > < a href ="#border-image "> border-image</ a > </ code > ’
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; ‘< 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+ ‘< code class =property > < a
34263425 href ="#border-radius "> border-radius</ a > </ code > ’ has no effect at
34273426 its corners; and the ‘< code class =property > < a
34283427 href ="#border-image "> border-image</ a > </ code > ’ is rendered for the
@@ -3475,265 +3474,12 @@ <h3 id=the-box-break><span class=secno>6.1 </span>The ‘<code
34753474 class =css > direction: ltr</ code > ’ will break on the left side.
34763475
34773476 < h3 id =the-box-shadow > < span class =secno > 6.2 </ span > The ‘< code
3478- class =property > < a href ="#box-shadow "> box-shadow</ a > </ code > ’ 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 "> <shadow></ a > </ var > [ ,
3491- < var > < a href ="#ltshadowgt "> <shadow></ 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 > ’ 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 <length> made absolute; any color computed; otherwise as
3522- specified
3523- </ table >
3524-
3525- < p > The ‘< code class =property > < a
3526- href ="#box-shadow "> box-shadow</ a > </ code > ’ 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 ‘< code class =css > < a href ="#inset "> inset</ a > </ code > ’
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 > <shadow></ var > </ dfn > = inset? && [ < var > <length></ var > {2,4} && < var > < a href ="#ltcolorgt "> <color></ a > </ var > ? ]</ pre >
3536-
3537- < p > The components of each < var > < a
3538- href ="#ltshadowgt "> <shadow></ 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 ‘< code class =css > < a href ="#inset "> inset</ a > </ code > ’
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 > ‘< code
3575- class =property > < a
3576- href ="#border-radius "> border-radius</ a > </ code > ’</ 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 ‘< code
3612- class =property > < a href ="#box-break "> box-break</ a > </ code > ’.
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 ‘< code class =css > < a
3727- href ="#box-shadow "> box-shadow</ a > </ code > ’ property applies to the
3728- ‘< code class =css > ::first-letter</ code > ’ pseudo-element, but
3729- not the ‘< code class =css > ::first-line</ code > ’ 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 ‘< code
3480+ class =property > box-shadow</ code > ’ 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 | <shadow> [ , <shadow> ]*
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 "> <shadow></ a > </ var > , < a
4907- href ="#ltshadowgt " title ="<shadow> "> < 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