CSS border-image Property

❮ Previous Complete CSS Reference Next ❯

Example

Specify an image as the border around an element:

#borderimg {
border-image: url(border.png) 30 round;
}

Try it Yourself »

More "Try it Yourself" examples below.

Definition and Usage

The border-image property allows you to specify an image to be used as the border around an element.

The border-image property is a shorthand property for:

Omitted values are set to their default values.

Default value:	none 100% 1 0 stretch
Inherited:	no
Animatable:	no. Read about animatable
Version:	CSS3
JavaScript syntax:	object.style.borderImage="url(border.png) 30 round" Try it

Browser Support

The numbers in the table specify the first browser version that fully supports the property.

Numbers followed by -webkit-, -moz-, or -o- specify the first version that worked with a prefix.

Property
border-image	16.0 4.0 -webkit-	11.0	15.0 3.5 -moz-	6.0 3.1 -webkit-	15.0 11.0 -o-

Note: See individual browser support for each value below.

CSS Syntax

border-image: source slice width outset repeat|initial|inherit;

Property Values

Value	Description	Play it
border-image-source	The path to the image to be used as a border
border-image-slice	How to slice the border image	Play it »
border-image-width	The width of the border image
border-image-outset	The amount by which the border image area extends beyond the border box
border-image-repeat	Whether the border image should be repeated, rounded or stretched	Play it »
initial	Sets this property to its default value. Read about initial
inherit	Inherits this property from its parent element. Read about inherit

More Examples

Example

Different slice values completely changes the look of the border:

#borderimg1 {
  border: 10px solid transparent;
  padding: 15px;
  border-image: url(border.png) 50 round;
}

#borderimg2 {
border: 10px solid transparent;
padding: 15px;
  border-image: url(border.png) 20% round;
}

#borderimg3 {
border: 10px solid transparent;
padding: 15px;
border-image: url(border.png) 30% round;
}

Try it Yourself »

CSS tutorial: CSS Border Images

CSS Reference: border-image-outset property

CSS Reference: border-image-repeat property

CSS Reference: border-image-slice property

CSS Reference: border-image-source property

CSS Reference: border-image-width property

HTML DOM reference: borderImage property

❮ Previous Complete CSS Reference Next ❯