1. css
  2. /properties
  3. /border-image-width

border-image-width

Definition

The border-image-width property in CSS specifies the width of the border image. It is used in conjunction with the border-image-source property, which specifies the image to use for the border, and the border-image-slice property, which specifies how the image should be sliced into pieces to form the border.

Examples

Use a border image that is 10px wide:

border-image-width: 10px;

Use a border image that is 50% of the element's width:

border-image-width: 50%;

Use a border image that is 10px wide on the top and bottom, and 20px wide on the left and right:

border-image-width: 10px 20px;

Use a border image that is 10px wide on the top, 20px wide on the right and left, and 30px wide on the bottom:

border-image-width: 10px 20px 30px;

Use a border image that is 10px wide on the top, 20px wide on the right, 30px wide on the bottom, and 40px wide on the left:

border-image-width: 10px 20px 30px 40px;

Values

ValueDescription
<length>Specifies the width of the border image in pixels
<percent>Specifies the width of the border image as a percentage

Best Practices

  • Use the border-image-width property to specify the width of the border image. The width can be specified in pixels or as a percentage of the element's width.
  • If you want the border image to be the same width as the element's border, you can set the border-image-width property to 1, which will use the width of the element's border as the width of the border image.
  • If you want the border image to be a different width than the element's border, you can specify a different value for the border-image-width property. For example, you might use a smaller border image to create a subtle border effect, or a larger border image to create a more dramatic border.
  • Use the border-image-width property in conjunction with the border-image-source property, which specifies the image to use for the border, and the border-image-slice property, which specifies how the image should be sliced into pieces to form the border.
  • If you're using a small image or pattern as the border image, you may want to use a larger value for the border-image-width property to ensure that the image is clearly visible.
  • If you're using a large image as the border image, you may want to use a smaller value for the border-image-width property to prevent the image from overwhelming the element.
  • Keep in mind that the border-image-width property only works when used with the border-image-source property, which specifies the image to use for the border, and the border-image-slice property, which specifies how the image should be sliced into pieces to form the border.
  • Be aware that the border-image-width property is not supported in all browsers, so you may need to use a polyfill or fallback to using other methods for creating borders if you need to support older browsers.
  • You can use the border-image-width property in combination with other border properties, such as border-width and border-color, to create more complex border styles. For example, you might use a solid color border with a smaller width, and then use a border image with a larger width to add a decorative effect on top of the solid border.
  • When using the border-image-width property, make sure to test your border styles on different screen sizes and resolutions to ensure that the border looks good on all devices.

Browser Compatibility

ChromeFirefoxSafariInternet ExplorerMicrosoft EdgeOpera
YesYesYesYesYesYes

Note that support for the border-image-width property is limited in Internet Explorer 10 and earlier.