Whitespace
Utilities for controlling an element’s white-space property.
Class reference
Class | Properties |
---|---|
.whitespace-normal | white-space: normal; |
.whitespace-no-wrap | white-space: nowrap; |
.whitespace-pre | white-space: pre; |
.whitespace-pre-line | white-space: pre-line; |
.whitespace-pre-wrap | white-space: pre-wrap; |
Normal
Use .whitespace-normal
to cause text to wrap normally within an element. Newlines and spaces will be collapsed.
<div class="whitespace-normal">Lorem ipsum dolor sit amet, consectetur adipisicing elit. Omnis quidem itaque beatae, rem tenetur quia iure,
eum natus enim maxime
laudantium quibusdam illo nihil,
reprehenderit saepe quam aliquid odio accusamus.</div>
No Wrap
Use .whitespace-no-wrap
to prevent text from wrapping within an element. Newlines and spaces will be collapsed.
<div class="whitespace-no-wrap overflow-x-auto">Lorem ipsum dolor sit amet, consectetur adipisicing elit. Omnis quidem itaque beatae, rem tenetur quia iure,
eum natus enim maxime
laudantium quibusdam illo nihil,
reprehenderit saepe quam aliquid odio accusamus.</div>
Pre
Use .whitespace-pre
to preserve newlines and spaces within an element. Text will not be wrapped.
<div class="whitespace-pre overflow-x-auto">Lorem ipsum dolor sit amet, consectetur adipisicing elit. Omnis quidem itaque beatae, rem tenetur quia iure,
eum natus enim maxime
laudantium quibusdam illo nihil,
reprehenderit saepe quam aliquid odio accusamus.</div>
Pre Line
Use .whitespace-pre-line
to preserve newlines but not spaces within an element. Text will be wrapped normally.
<div class="whitespace-pre-line">Lorem ipsum dolor sit amet, consectetur adipisicing elit. Omnis quidem itaque beatae, rem tenetur quia iure,
eum natus enim maxime
laudantium quibusdam illo nihil,
reprehenderit saepe quam aliquid odio accusamus.</div>
Pre Wrap
Use .whitespace-pre-wrap
to preserve newlines and spaces within an element. Text will be wrapped normally.
<div class="whitespace-pre-wrap">Lorem ipsum dolor sit amet, consectetur adipisicing elit. Omnis quidem itaque beatae, rem tenetur quia iure,
eum natus enim maxime
laudantium quibusdam illo nihil,
reprehenderit saepe quam aliquid odio accusamus.</div>
Responsive
To control the whitespace property of an element only at a specific breakpoint, add a {screen}:
prefix to any existing whitespace utility. For example, adding the class md:whitespace-pre
to an element would apply the whitespace-pre
utility at medium screen sizes and above.
For more information about Tailwind’s responsive design features, check out the Responsive Design documentation.
<div class="whitespace-normal sm:whitespace-no-wrap md:whitespace-pre lg:whitespace-pre-line xl:whitespace-pre-wrap ...">...</div>
Customizing
Responsive and pseudo-class variants
By default, only responsive variants are generated for whitespace utilities.
You can control which variants are generated for the whitespace utilities by modifying the whitespace
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: {
// ...
- whitespace: ['responsive'],
+ whitespace: ['responsive', 'hover', 'focus'],
}
}
Disabling
If you don’t plan to use the whitespace utilities in your project, you can disable them entirely by setting the whitespace
property to false
in the corePlugins
section of your config file:
// tailwind.config.js
module.exports = {
corePlugins: {
// ...
+ whitespace: false,
}
}