border-image

  • Article

Important

This documentation is preliminary and subject to change.

A shorthand property that sets values for border-image-source, border-image-slice, border-image-outset, and border-image-repeat.

Syntax

{ border-image: sUrlsSlicesOutsetsRepeat }

Possible values

sUrl

String that specifies the location of the image to be used to draw the border.

sSlice

String that specifies one of the following values:

percentageDefault. Percentage relative to the size of the image. Default value is 100%. Any percentage over 100% is treated as 100%.
integerNumber of pixels (for a bitmap image) or vector coordinates (for a vector image) to display.
fillPreserves the middle part of the image.

The property has a default value of 100%. It is not inherited. Negative values are not permitted.

sOutset

String that specifies the amount by which the border-image-area is drawn outside of the border box.

sRepeat

String that specifies one of the following values:

stretchThe image is stretched to fill the area.
repeatThe image is repeated to fill the area
roundThe image is repeated to fill the area. If the area is a non-integer multiple of the image, the image is rescaled to fit.
spaceThe image is repeated to fill the area. If the area is a non-integer multiple of the image, space is inserted between repeated instances of the image to fill the remainder.

This property has a default value of stretch. It is not inherited.

Standards information

This property is defined in CSS Backgrounds and Borders Module Level 3 Gg721759.xtlink_newWindow(en-us,Expression.40).png.

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

border-image-source
border-image-slice
border-image-outset
border-image-repeat

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