Tailwind CSS home page
Tailwind CSS on GitHub

Border Collapse

Utilities for controlling whether table borders should collapse or be separated.

Default class reference

Class
Properties
border-collapseborder-collapse: collapse;
border-separateborder-collapse: separate;

Separate

Use border-separate to force each cell to display its own separate borders.

State City
Indiana Indianapolis
Ohio Columbus
Michigan Detroit 
<table class="border-separate border border-green-800 ...">
  <thead>
    <tr>
      <th class="border border-green-600 ...">State</th>
      <th class="border border-green-600 ...">City</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td class="border border-green-600 ...">Indiana</td>
      <td class="border border-green-600 ...">Indianapolis</td>
    </tr>
    <tr>
      <td class="border border-green-600 ...">Ohio</td>
      <td class="border border-green-600 ...">Columbus</td>
    </tr>
    <tr>
      <td class="border border-green-600 ...">Michigan</td>
      <td class="border border-green-600 ...">Detroit</td>
    </tr>
  </tbody>
</table>

Collapse

Use border-collapse to combine adjacent cell borders into a single border when possible. Note that this includes collapsing borders on the top-level <table> tag.

State City
Indiana Indianapolis
Ohio Columbus
Michigan Detroit 
<table class="border-collapse border border-green-800 ...">
  <thead>
    <tr>
      <th class="border border-green-600 ...">State</th>
      <th class="border border-green-600 ...">City</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td class="border border-green-600 ...">Indiana</td>
      <td class="border border-green-600 ...">Indianapolis</td>
    </tr>
    <tr>
      <td class="border border-green-600 ...">Ohio</td>
      <td class="border border-green-600 ...">Columbus</td>
    </tr>
    <tr>
      <td class="border border-green-600 ...">Michigan</td>
      <td class="border border-green-600 ...">Detroit</td>
    </tr>
  </tbody>
</table>

Customizing

Variants

By default, only responsive variants are generated for border collapse utilities.

You can control which variants are generated for the border collapse utilities by modifying the borderCollapse 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: {
      extend: {
        // ...
+       borderCollapse: ['hover', 'focus'],
      }
    }
  }

Disabling

If you don't plan to use the border collapse utilities in your project, you can disable them entirely by setting the borderCollapse property to false in the corePlugins section of your config file:

  // tailwind.config.js
  module.exports = {
    corePlugins: {
      // ...
+     borderCollapse: false,
    }
  }
← OpacityTable Layout →