Border Width
Utilities for controlling the width of an element's borders.
All sides
Use the .border
, .border-0
, .border-2
, .border-4
, or .border-8
utilities to set the border width for all sides of an element.
.border-0
.border
.border-2
.border-4
.border-8
<div class="border-0 border-gray-600 ..."></div>
<div class="border border-gray-600 ..."></div>
<div class="border-2 border-gray-600 ..."></div>
<div class="border-4 border-gray-600 ..."></div>
<div class="border-8 border-gray-600 ..."></div>
Individual sides
Use the .border-{side}
, .border-{side}-0
, .border-{side}-2
, .border-{side}-4
, or .border-{side}-8
utilities to set the border width for one side of an element.
.border-t-2
.border-r-2
.border-b-2
.border-l-2
<div class="border-t-2 border-gray-600 ..."></div>
<div class="border-r-2 border-gray-600 ..."></div>
<div class="border-b-2 border-gray-600 ..."></div>
<div class="border-l-2 border-gray-600 ..."></div>
Between elementsv1.3.0+
You can also add borders between child elements using the divide-{x/y}-{width}
and divide-{color}
utilities.
Learn more in the Divide Width and Divide Color documentation.
<div class="divide-y divide-gray-400">
<div class="text-center py-2">1</div>
<div class="text-center py-2">2</div>
<div class="text-center py-2">3</div>
</div>
Responsive
To control the border width of an element at a specific breakpoint, add a {screen}:
prefix to any existing border width utility. For example, use md:border-t-4
to apply the border-t-4
utility at only medium screen sizes and above.
For more information about Tailwind's responsive design features, check out the Responsive Design documentation.
<div class="border-2 sm:border-t-8 md:border-r-8 lg:border-b-8 xl:border-8">
</div>
Customizing
Border Widths
By default Tailwind provides five border-width
utilities, and the same number of utilities per side (top, right, bottom, and left). You change, add, or remove these by editing the theme.borderWidth
section of your Tailwind config. The values in this section will also control which utilities will be generated side.
// tailwind.config.js
module.exports = {
theme: {
borderWidth: {
default: '1px',
'0': '0',
'2': '2px',
+ '3': '3px',
'4': '4px',
+ '6': '6px',
- '8': '8px',
}
}
}
Responsive and pseudo-class variants
By default, only responsive variants are generated for border width utilities.
You can control which variants are generated for the border width utilities by modifying the borderWidth
property in the variants
section of your tailwind.config.js
file.
For example, this config will also generate hover and focus variants:
// tailwind.config.js
module.exports = {
variants: {
// ...
- borderWidth: ['responsive'],
+ borderWidth: ['responsive', 'hover', 'focus'],
}
}
Disabling
If you don't plan to use the border width utilities in your project, you can disable them entirely by setting the borderWidth
property to false
in the corePlugins
section of your config file:
// tailwind.config.js
module.exports = {
corePlugins: {
// ...
+ borderWidth: false,
}
}