background-clip

Important

This documentation is preliminary and subject to change.

Sets the background painting area.

Syntax

{ background-clip: sClip }

Possible values

sClip

String that specifies one of the following values:

border-box	Default. The background is painted within (clipped to) the border box.
padding-box	The background is painted within (clipped to) the padding box.
content-box	The background is painted within (clipped to) the content box.

This property has a default value of border-box. It is not inherited.

Remarks

The background of a box can have multiple layers. The number of layers is determined by the number of comma-separated values in the background-image property. Each of the images is sized, positioned, and tiled according to the corresponding value in the other background properties (background-attachment, background-clip, background-origin, background-position, background-repeat, and background-size). The first image in the list is the layer closest to the user; the next one is painted behind the first, and so on.

Standards information

This property is defined in CSS Selectors Level 3 .

Applies to

a, address, b, big, blockquote, body, button, caption, center, cite, code, col, colgroup, custom, dd, defaults, dfn, div, dl, dt, em, fieldset, form, hn, html, i, img, input type=button, input type=checkbox, input type=file, input type=image, input type=password, input type=radio, input type=reset, input type=submit, input type=text, li, ol, p, s, span, sub, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, var, xmp

See also

Concepts

background
background-attachment
background-color
background-image
background-origin
background-position
background-repeat
background-size

Send feedback about this topic to Microsoft. © 2011 Microsoft Corporation. All rights reserved.