border-image-repeat

Summary

The border-image-repeat CSS property defines how the middle part of a border image is handled so that it can match the size of the border. It has a one-value syntax that describes the behavior of all the sides, and a two-value syntax that sets a different value for the horizontal and vertical behavior.

Syntax

/* border-image-repeat: type */
border-image-value: stretch;

/* border-image-repeat: horizontal vertical */
border-image-width: round stretch;

/* Global values */
border-image-repeat: inherit;
border-image-repeat: initial;
border-image-repeat: unset;

Values

type

One of the stretch, repeat, or round keywords denoting how the image is treated both horizontally and vertically.

horizontal

One of the stretch, repeat, or round keywords denoting how the image is treated horizontally.

vertical

One of the stretch, repeat, or round keywords denoting how the image is treated vertically.

stretch

Keyword indicating that the image must be stretched to fill the gap between the two borders.

repeat

Keyword indicating that the image must be repeated until it fills the gap between the two borders.

round

Keyword indicating that the image must be repeated until it fills the gap between the two borders. If the image doesn't fit after being repeated for an integral number of times, the image is rescaled to fit.

space

The image is tiled (repeated) to fill the area. If it does not fill the area with a whole number of tiles, the extra space is distributed around the tiles.

Formal syntax

[ stretch | repeat | round | space ]{1,2}

Examples

See border-image for examples of what repeat values will do.

Specifications

Browser compatibility

[1] Support the space value, but the actual effect is the same as the repeat value.

[2] Support the round value, but the actual effect is the same as the repeat value.

[3] See bug 720531.

[4] See Chrome bug.

[5] See WebKit bug.

See also

• css-tricks border-image