Grid Auto Columns
Tailwind CSS version
v1.9.0+
Utilities for controlling the size of implicitly-created grid columns.
Class reference
| Class | Properties |
|---|---|
| .auto-cols-auto | grid-auto-columns: auto; |
| .auto-cols-min | grid-auto-columns: min-content; |
| .auto-cols-max | grid-auto-columns: max-content; |
| .auto-cols-fr | grid-auto-columns: minmax(0, 1fr); |
Usage
Use the auto-cols-{size} utilities to control the size implicitly-created grid columns.
1. <div class="grid grid-flow-col auto-cols-max">
2. <div>1</div>
3. <div>2</div>
4. <div>3</div>
5. </div>
Responsive
To control the grid-auto-columns property at a specific breakpoint, add a {screen}: prefix to any existing grid-auto-columns utility. For example, use md:auto-cols-min to apply the auto-cols-min utility at only medium screen sizes and above.
1. <div class="grid grid-flow-col auto-cols-max md:auto-cols-min">
2. <div>1</div>
3. <div>2</div>
4. <div>3</div>
5. </div>
For more information about Tailwind’s responsive design features, check out the Responsive Design documentation.
Customizing
By default Tailwind includes four general purpose grid-auto-columns utilities. You can customize these in the theme.gridAutoColumns section of your tailwind.config.js file.
1. // tailwind.config.js
2. module.exports = {
3. theme: {
4. extend: {
5. gridAutoColumns: {
6. '2fr': 'minmax(0, 2fr)',
7. }
8. }
9. }
10. }
Learn more about customizing the default theme in the theme customization documentation.
Responsive and pseudo-class variants
By default, only responsive variants are generated for grid-auto-columns utilities.
You can control which variants are generated for the grid-auto-columns utilities by modifying the gridAutoColumns property in the variants section of your tailwind.config.js file.
For example, this config will also generate hover and focus variants:
1. // tailwind.config.js
2. module.exports = {
3. variants: {
4. // ...
5. - gridAutoColumns: ['responsive'],
6. + gridAutoColumns: ['responsive', 'hover', 'focus'],
7. }
8. }
Disabling
If you don’t plan to use the grid-auto-columns utilities in your project, you can disable them entirely by setting the gridAutoColumns property to false in the corePlugins section of your config file:
1. // tailwind.config.js
2. module.exports = {
3. corePlugins: {
4. // ...
5. + gridAutoColumns: false,
6. }
7. }
