This topic has not yet been rated - Rate this topic

background-origin property

[This documentation is preliminary and is subject to change.]

Sets or retrieves the background positioning area of a box or multiple boxes.

CSS Backgrounds and Borders Module Level 3, Section 3.8

Syntax

background-origin: padding-box | border-box | content-box

Property values

A variable of type String that specifies or receives the position of the box or boxes.

padding-box

Default. The position is relative to the padding box. For single boxes, "0 0" is the upper-left corner of the padding edge; "100% 100%" is the lower-right corner.

border-box

The position is relative to the border box.

content-box

The position is relative to the content box.

CSS information

Applies ToAll elements
Mediavisual
Inheritedno
Initial Value

Standards information

Remarks

For elements rendered as a single box, the background-origin property specifies the background positioning area. For elements rendered as multiple boxes (for instance, inline boxes on several lines or boxes on several pages), this property specifies which boxes determine the background positioning areas.

If the background-attachment value for this image is fixed, then the background-origin property has no effect. In this case, the background positioning area is the initial containing block.

In a Metro style app using JavaScript, 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.

See also

style
CSSStyleDeclaration
currentStyle
defaults
LayoutRect
runtimeStyle
style
Reference
background-color
background-image
background-repeat
background-attachment
background-position
background-clip
background-size
background

 

 

Build date: 3/13/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ