Overflow

Utilities for controlling how an element handles content that is too large for the container.

Class reference

ClassProperties
.overflow-autooverflow: auto;
.overflow-hiddenoverflow: hidden;
.overflow-visibleoverflow: visible;
.overflow-scrolloverflow: scroll;
.overflow-x-autooverflow-x: auto;
.overflow-y-autooverflow-y: auto;
.overflow-x-hiddenoverflow-x: hidden;
.overflow-y-hiddenoverflow-y: hidden;
.overflow-x-visibleoverflow-x: visible;
.overflow-y-visibleoverflow-y: visible;
.overflow-x-scrolloverflow-x: scroll;
.overflow-y-scrolloverflow-y: scroll;
.scrolling-touch-webkit-overflow-scrolling: touch;
.scrolling-auto-webkit-overflow-scrolling: auto;

Visible

Use .overflow-visible to prevent content within an element from being clipped. Note that any content that overflows the bounds of the element will then be visible.

Overflow - 图1

  1. <div class="overflow-visible h-16 ...">Lorem ipsum dolor sit amet...</div>

Auto

Use .overflow-auto to add scrollbars to an element in the event that its content overflows the bounds of that element. Unlike .overflow-scroll, which always show scrollbars, this utility will only show them if scrolling is necessary.

Overflow - 图2

  1. <div class="overflow-auto h-32 ...">Lorem ipsum dolor sit amet...</div>

Hidden

Use .overflow-hidden to clip any content within an element that overflows the bounds of that element.

Overflow - 图3

  1. <div class="overflow-hidden h-32 ...">Lorem ipsum dolor sit amet...</div>

Scroll horizontally if needed

Use .overflow-x-auto to allow horizontal scrolling if needed.

Overflow - 图4

  1. <div class="overflow-x-auto ...">QrLmmW69vMQD...</div>

Scroll vertically if needed

Use .overflow-y-auto to allow vertical scrolling if needed.

Overflow - 图5

  1. <div class="overflow-y-auto h-32 ...">Lorem ipsum dolor sit amet...</div>

Scroll horizontally always

Use .overflow-x-scroll to allow horizontal scrolling and always show scrollbars unless always-visible scrollbars are disabled by the operating system.

Overflow - 图6

  1. <div class="overflow-x-scroll ...">QrLmmW69vMQD...</div>

Scroll vertically always

Use .overflow-y-scroll to allow vertical scrolling and always show scrollbars unless always-visible scrollbars are disabled by the operating system.

Overflow - 图7

  1. <div class="overflow-y-scroll h-32 ...">Lorem ipsum dolor sit amet...</div>

Scroll in all directions

Use .overflow-scroll to add scrollbars to an element. Unlike .overflow-auto, which only shows scrollbars if they are necessary, this utility always shows them. Note that some operating systems (like macOS) hide unnecessary scrollbars regardless of this setting.

Overflow - 图8

  1. <div class="overflow-scroll ...">QrLmmW69vMQD...</div>
  2. <div class="overflow-scroll h-32 ...">Lorem ipsum dolor sit amet...</div>
  3. <div class="overflow-scroll h-32 ...">Loremipsumdolorsitamet...</div>

Momentum-based scrolling on touch devices

Use .scrolling-touch to use momentum-based scrolling (where supported) on touch devices.

Overflow - 图9

  1. <div class="scrolling-touch overflow-auto h-32 ...">Lorem ipsum dolor sit amet...</div>

Use .scrolling-auto to use normal non-momentum-based scrolling on touch devices.

This is mostly useful for undoing .scrolling-touch at larger screen sizes.

Overflow - 图10

  1. <div class="scrolling-auto overflow-auto h-32 ...">Lorem ipsum dolor sit amet...</div>

Responsive

To apply an overflow utility only at a specific breakpoint, add a {screen}: prefix to the existing class name. For example, adding the class md:overflow-scroll to an element would apply the overflow-scroll utility at medium screen sizes and above.

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

  1. <div class="overflow-auto sm:overflow-visible md:overflow-hidden lg:overflow-x-scroll xl:overflow-y-scroll ...">
  2. Lorem ipsum dolor sit amet...
  3. </div>

Overflow - 图11

Customizing

Responsive and pseudo-class variants

By default, only responsive variants are generated for overflow utilities.

You can control which variants are generated for the overflow utilities by modifying the overflow 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. - overflow: ['responsive'],
  6. + overflow: ['responsive', 'hover', 'focus'],
  7. }
  8. }

Disabling

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

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