Grid Auto Columns
Utilities for controlling the size of implicitly-created grid columns.
Default 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 of implicitly-created grid columns.
<div class="grid grid-flow-col auto-cols-max">
<div>1</div>
<div>2</div>
<div>3</div>
</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.
<div class="grid grid-flow-col auto-cols-max md:auto-cols-min">
<div>1</div>
<div>2</div>
<div>3</div>
</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.
// tailwind.config.js
module.exports = {
theme: {
extend: {
gridAutoColumns: {
'2fr': 'minmax(0, 2fr)',
}
}
}
}
Learn more about customizing the default theme in the theme customization documentation.
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:
// tailwind.config.js
module.exports = {
variants: {
extend: {
// ...
+ gridAutoColumns: ['hover', 'focus'],
}
}
}
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:
// tailwind.config.js
module.exports = {
corePlugins: {
// ...
+ gridAutoColumns: false,
}
}