background-attachment
Utilities for controlling how a background image behaves when scrolling.
Quick reference
| Class | Styles |
|---|---|
bg-fixed | background-attachment: fixed; |
bg-local | background-attachment: local; |
bg-scroll | background-attachment: scroll; |
Examples
Fixing the background image
Use the bg-fixed utility to fix the background image relative to the viewport:
html
<!-- [!code classes:bg-fixed] -->
<div class="bg-[url(/img/mountains.jpg)] bg-fixed ...">
<!-- ... -->
</div>1
2
3
4
2
3
4
Scrolling with the container
Use the bg-local utility to scroll the background image with the container and the viewport:
html
<!-- [!code classes:bg-local] -->
<div class="bg-[url(/img/mountains.jpg)] bg-local ...">
<!-- ... -->
</div>1
2
3
4
2
3
4
Scrolling with the viewport
Use the bg-scroll utility to scroll the background image with the viewport, but not with the container:
html
<!-- [!code classes:bg-scroll] -->
<div class="bg-[url(/img/mountains.jpg)] bg-scroll ...">
<!-- ... -->
</div>1
2
3
4
2
3
4
Responsive design
Prefix a background-attachment utility with a breakpoint variant like md: to only apply the utility at medium screen sizes and above:
html
<div class="bg-local md:bg-fixed ...">
<!-- ... -->
</div>1
2
3
2
3