Back to Tailwindcss

Backdrop Filter Blur

src/docs/backdrop-filter-blur.mdx

latest4.6 KB
Original Source

import { ApiTable } from "@/components/api-table.tsx"; import { CustomizingYourTheme, ResponsiveDesign, UsingACustomValue } from "@/components/content.tsx"; import { Example } from "@/components/example.tsx"; import { Figure } from "@/components/figure.tsx";

export const title = "backdrop-filter: blur()"; export const description = "Utilities for applying backdrop blur filters to an element.";

<ApiTable rows={[ ["backdrop-blur-xs", "backdrop-filter: blur(var(--blur-xs)); /* 4px /"], ["backdrop-blur-sm", "backdrop-filter: blur(var(--blur-sm)); / 8px /"], ["backdrop-blur-md", "backdrop-filter: blur(var(--blur-md)); / 12px /"], ["backdrop-blur-lg", "backdrop-filter: blur(var(--blur-lg)); / 16px /"], ["backdrop-blur-xl", "backdrop-filter: blur(var(--blur-xl)); / 24px /"], ["backdrop-blur-2xl", "backdrop-filter: blur(var(--blur-2xl)); / 40px /"], ["backdrop-blur-3xl", "backdrop-filter: blur(var(--blur-3xl)); / 64px */"], ["backdrop-blur-none", "backdrop-filter: ;"], ["backdrop-blur-(<custom-property>)", "backdrop-filter: blur(var(<custom-property>));"], ["backdrop-blur-[<value>]", "backdrop-filter: blur(<value>);"], ]} />

Examples

Basic example

Use utilities like backdrop-blur-sm and backdrop-blur-lg to control an element’s backdrop blur:

<Figure> <Example padding={false}> { <div className="flex scroll-p-8 justify-start overflow-scroll sm:block sm:overflow-visible"> <div className="flex shrink-0 items-center justify-around gap-6 p-8 font-mono font-bold sm:gap-4"> <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-blur-none </p> <div className="relative"> <div className="absolute inset-6 size-20 bg-white/30 backdrop-blur-none"></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 dark:text-gray-400">
        backdrop-blur-sm
      </p>
      <div className="relative">
        <div className="absolute inset-6 size-20 bg-white/30 backdrop-blur-sm"></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 dark:text-gray-400">
        backdrop-blur-md
      </p>
      <div className="relative">
        <div className="absolute inset-6 size-20 bg-white/30 backdrop-blur-md"></div>
        
        <div className="absolute inset-0 rounded-lg ring-1 ring-black/10 ring-inset"></div>
      </div>
    </div>
  </div>
</div>

} </Example>

html
<!-- [!code classes:backdrop-blur-none,backdrop-blur-sm,backdrop-blur-md] -->
<div class="bg-[url(/img/mountains.jpg)]">
  <div class="bg-white/30 backdrop-blur-none ..."></div>
</div>
<div class="bg-[url(/img/mountains.jpg)]">
  <div class="bg-white/30 backdrop-blur-sm ..."></div>
</div>
<div class="bg-[url(/img/mountains.jpg)]">
  <div class="bg-white/30 backdrop-blur-md ..."></div>
</div>
</Figure>

Using a custom value

<UsingACustomValue utility="backdrop-blur" value="2px" name="backdrop blur" />

Responsive design

<ResponsiveDesign property="backdrop-filter: blur()" defaultClass="backdrop-blur-none" featuredClass="backdrop-blur-lg" />

Customizing your theme

<CustomizingYourTheme utility="backdrop-blur" themeKey="blur" name="backdrop blur" customName="2xs" customValue="2px" />