Whitespace

Utilities for controlling an element’s white-space property.

Class reference

Class
Properties
.whitespace-normalwhite-space: normal;
.whitespace-no-wrapwhite-space: nowrap;
.whitespace-prewhite-space: pre;
.whitespace-pre-linewhite-space: pre-line;
.whitespace-pre-wrapwhite-space: pre-wrap;

Normal

Use .whitespace-normal to cause text to wrap normally within an element. Newlines and spaces will be collapsed.

Whitespace - 图1

  1. <div class="whitespace-normal">Lorem ipsum dolor sit amet, consectetur adipisicing elit. Omnis quidem itaque beatae, rem tenetur quia iure,
  2. eum natus enim maxime
  3. laudantium quibusdam illo nihil,
  4. 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.

Whitespace - 图2

  1. <div class="whitespace-no-wrap overflow-x-auto">Lorem ipsum dolor sit amet, consectetur adipisicing elit. Omnis quidem itaque beatae, rem tenetur quia iure,
  2. eum natus enim maxime
  3. laudantium quibusdam illo nihil,
  4. reprehenderit saepe quam aliquid odio accusamus.</div>

Pre

Use .whitespace-pre to preserve newlines and spaces within an element. Text will not be wrapped.

Whitespace - 图3

  1. <div class="whitespace-pre overflow-x-auto">Lorem ipsum dolor sit amet, consectetur adipisicing elit. Omnis quidem itaque beatae, rem tenetur quia iure,
  2. eum natus enim maxime
  3. laudantium quibusdam illo nihil,
  4. 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.

Whitespace - 图4

  1. <div class="whitespace-pre-line">Lorem ipsum dolor sit amet, consectetur adipisicing elit. Omnis quidem itaque beatae, rem tenetur quia iure,
  2. eum natus enim maxime
  3. laudantium quibusdam illo nihil,
  4. 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.

Whitespace - 图5

  1. <div class="whitespace-pre-wrap">Lorem ipsum dolor sit amet, consectetur adipisicing elit. Omnis quidem itaque beatae, rem tenetur quia iure,
  2. eum natus enim maxime
  3. laudantium quibusdam illo nihil,
  4. 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.

Whitespace - 图6

all

Whitespace - 图7

sm

Whitespace - 图8

md

Whitespace - 图9

lg

Whitespace - 图10

xl

  1. <div class="whitespace-normal sm:whitespace-no-wrap md:whitespace-pre lg:whitespace-pre-line xl:whitespace-pre-wrap ...">...</div>

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.

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:

  1. // tailwind.config.js
  2. module.exports = {
  3. variants: {
  4. // ...
  5. - whitespace: ['responsive'],
  6. + whitespace: ['responsive', 'hover', 'focus'],
  7. }
  8. }

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:

  1. // tailwind.config.js
  2. module.exports = {
  3. corePlugins: {
  4. // ...
  5. + whitespace: false,
  6. }
  7. }

← Vertical Align   Word Break →