src/docs/backdrop-filter.mdx
import { ApiTable } from "@/components/api-table.tsx"; import { Example } from "@/components/example.tsx"; import { Figure } from "@/components/figure.tsx"; import { ResponsiveDesign, TargetingSpecificStates, UsingACustomValue } from "@/components/content.tsx";
export const title = "backdrop-filter"; export const description = "Utilities for applying backdrop filters to an element.";
<ApiTable rows={[ ["backdrop-filter-none", "backdrop-filter: none;"], ["backdrop-filter-(<custom-property>)", "backdrop-filter: var(<custom-property>);"], ["backdrop-filter-[<value>]", "backdrop-filter: <value>;"], ]} />
Use utilities like backdrop-blur-xs and backdrop-grayscale to apply filters to an element's backdrop:
<div className="absolute inset-0 rounded-lg ring-1 ring-black/10 ring-inset"></div>
</div>
</div>
<div className="flex shrink-0 flex-col items-center">
<p className="mb-3 text-center font-mono text-xs font-medium text-gray-500 dark:text-gray-400">
backdrop-grayscale
</p>
<div className="relative">
<div className="absolute inset-6 size-20 bg-white/30 backdrop-grayscale"></div>
<div className="absolute inset-0 rounded-lg ring-1 ring-black/10 ring-inset"></div>
</div>
</div>
<div className="flex shrink-0 flex-col items-center">
<p className="mb-3 text-center font-mono text-xs font-medium text-gray-500 italic dark:text-gray-400">
combined
</p>
<div className="relative">
<div className="absolute inset-6 size-20 bg-white/30 backdrop-blur-xs backdrop-grayscale"></div>
<div className="absolute inset-0 rounded-lg ring-1 ring-black/10 ring-inset"></div>
</div>
</div>
</div>
</div>
} </Example>
<!-- [!code classes:backdrop-blur-xs,backdrop-grayscale] -->
<div class="bg-[url(/img/mountains.jpg)] ...">
<div class="backdrop-blur-xs ..."></div>
</div>
<div class="bg-[url(/img/mountains.jpg)] ...">
<div class="backdrop-grayscale ..."></div>
</div>
<div class="bg-[url(/img/mountains.jpg)] ...">
<div class="backdrop-blur-xs backdrop-grayscale ..."></div>
</div>
You can combine the following backdrop filter utilities: blur, brightness, contrast, grayscale, hue-rotate, invert, opacity, saturate, and sepia.
Use the backdrop-filter-none utility to remove all of the backdrop filters applied to an element:
<!-- [!code classes:md:backdrop-filter-none] -->
<div class="backdrop-blur-md backdrop-brightness-150 md:backdrop-filter-none"></div>
<TargetingSpecificStates property="backdrop-filter" defaultClass="backdrop-blur-sm" featuredClass="backdrop-filter-none" />