Word Break

Utilities for controlling word breaks in an element.

Default class reference

Class
Properties
break-normaloverflow-wrap: normal; word-break: normal;
break-wordsoverflow-wrap: break-word;
break-allword-break: break-all;

Normal

Use break-normal to only add line breaks at normal word break points.

Word Break - 图1

  1. <p class="break-normal ...">...</p>

Break Words

Use break-words to add line breaks mid-word if needed.

Word Break - 图2

  1. <p class="break-words ...">...</p>

Break All

Use break-all to add line breaks whenever necessary, without trying to preserve whole words.

Word Break - 图3

  1. <p class="break-all ...">...</p>

Responsive

To control the word breaks in an element only at a specific breakpoint, add a {screen}: prefix to any existing word break utility. For example, adding the class md:break-all to an element would apply the break-all utility at medium screen sizes and above.

  1. <p class="break-normal md:break-all ...">
  2. <!-- ... -->
  3. </p>

For more information about Tailwind’s responsive design features, check out the Responsive Design documentation.

Customizing

Variants

By default, only responsive variants are generated for word break utilities.

You can control which variants are generated for the word break utilities by modifying the wordBreak 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. extend: {
  5. // ...
  6. + wordBreak: ['hover', 'focus'],
  7. }
  8. }
  9. }

Disabling

If you don’t plan to use the word break utilities in your project, you can disable them entirely by setting the wordBreak property to false in the corePlugins section of your config file:

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

←Whitespace   Background Attachment→