Tailwind CSS doesn't provide support for border-image out of the box, therefore this plugin aims to provide you with a set of utilities to meet that need.
The plugin it's not opinionated, meaning it doesn't provide any UI components nor override any of the tailwind's default configuration or values.
As an example, it makes it possible for this css:
``CSS div { border-image: linear-gradient(to left, #581c87, #d8b4fe) 1 fill / 0 / 0 100% stretch; } `
The border-image-source CSS property sets the source image used to create an element's border image. (Keep in mind that all gradients are also considered images).
To set the border-image source you can use the
border-image-{value}.{value} can be anything defined in your theme.backgroundImage meaning that any gradient or image resource included in your theme can be used as a border image source. For example border-image-gradient-to-t.
It also supports arbitrary values, that way if you don't want to add an specific backgroundImage to your theme you can just inline it. For example:
border-image-slice has it's own set of values that can be extended or overwritten through the borderSlice property on the tailwind.config.js.
Since border-image-slice works with unitless values (no pixels, rems, etc) it's the only property that requires custom values.
The default
theme.spacing values can't be used because they contain units (rem). The borderSlice values follow the same pattern as the default spacing, width or height that we are used to but without units.
border-slice- | {theme.borderSlice} / {arbitrary} | Sets a value for all four slices | | border-slice-x- | {theme.borderSlice} / {arbitrary} | Sets a value for the left and right slices | | border-slice-y- | {theme.borderSlice} / {arbitrary} | Sets a value for the top and bottom slices | | border-slice-t- | {theme.borderSlice} / {arbitrary} | Sets a value for the top slice | | border-slice-r- | {theme.borderSlice} / {arbitrary} | Sets a value for the right slice | | border-slice-b- | {theme.borderSlice} / {arbitrary} | Sets a value for the bottom slice | | border-slice-l- | {theme.borderSlice} / {arbitrary} | Sets a value for the left slice |
The border-image-slice CSS property divides the image specified by border-image-source into regions. These regions form the components of an element's border image.
The slice property accepts up to four values, acting also as a short-hand (like margin and border properties do). This means that if you provide one value it will be used for the four slices.
This plugin also proivdes utilities to set only
x, y or individual values if you need to customize each of them individually.
With the slice property you can control the 8 outer slices. To control the inner slice (the 9th slice) you should use the fill property. To do that you should also make use of the
border-slice- utilities, this time targeting the fill value.
border-image-width- | {theme.width} / {arbitrary} | Sets a value for all four widths | | border-image-width-x- | {theme.width} / {arbitrary} | Sets a value for the left and right widths | | border-image-width-y- | {theme.height} / {arbitrary} | Sets a value for the top and bottom widths | | border-image-width-t- | {theme.height} / {arbitrary} | Sets a value for the top width | | border-image-width-r- | {theme.width} / {arbitrary} | Sets a value for the right width | | border-image-width-b- | {theme.height} / {arbitrary} | Sets a value for the bottom width | | border-image-width-l- | {theme.width} / {arbitrary} | Sets a value for the left width |
The border-image-width CSS property sets the width of an element's border image and like slice property, the witdh is also a short-and for the four sides.
border-outset- | {theme.width} / {arbitrary} | Sets a value for all four outsets | | border-outset-x- | {theme.width} / {arbitrary} | Sets a value for the left and right outsets | | border-outset-y- | {theme.height} / {arbitrary} | Sets a value for the top and bottom outsets | | border-outset-t- | {theme.height} / {arbitrary} | Sets a value for the top outset | | border-outset-r- | {theme.width} / {arbitrary} | Sets a value for the right outset | | border-outset-b- | {theme.height} / {arbitrary} | Sets a value for the bottom outset | | border-outset-l- | {theme.width} / {arbitrary} | Sets a value for the left outset |
The border-image-outset CSS property sets the distance by which an element's border image is set out from its border box.
The parts of the border image that are rendered outside the element's border box with border-image-outset do not trigger overflow scrollbars and don't capture mouse events.
Like the slice and width property, the witdh is also a short-and for the four sides.
The border-image-repeat CSS property defines how the edge regions and middle region of a source image are adjusted to fit the dimensions of an element's border image.
Resources
If you would like to know more about what you can do with this powerful CSS property. I recommend taking a look at this resources.
- Temani Afif - [The complex but awesome CSS border-image property][the-complex-but-awesome-css-border-image-property] - Kevin Powell - [The border property you never knew you needed][the-border-property-you-never-knew-you-needed] - CSS Tricks - [Border Image][css-tricks-border-image] - [MDN][mdn-border-image]
$3
If you really like my job and you would like to  I'd be eternally grateful 😊
