Tailwind CSS v1.0 is here! Learn more →

Background Attachment

Utilities for controlling how a background image behaves when scrolling.

Work in progress!

More detailed documentation is coming soon, but in the meantime here's a quick class reference.

Class reference

Class Properties
.bg-fixed background-attachment: fixed;
.bg-local background-attachment: local;
.bg-scroll background-attachment: scroll;

Customizing

Responsive and State Variants

By default, only responsive variants are generated for background attachment utilities.

You can control which variants are generated for the background attachment utilities by modifying the backgroundAttachment property in the modules section of your Tailwind config file.

For example, this config will also generate hover and focus variants:

{
// ...
modules: {
    // ...
-   backgroundAttachment: ['responsive'],
+   backgroundAttachment: ['responsive', 'hover', 'focus', 'active', 'group-hover'],
}
}

Disabling

If you don't plan to use the background attachment utilities in your project, you can disable them entirely by setting the backgroundAttachment property to false in the modules section of your config file:

{
// ...
modules: {
    // ...
-   backgroundAttachment: ['responsive'],
+   backgroundAttachment: false,
}
}