AgentSkillsCN

glassmorphism

创建带有模糊、透明度和微妙边框的磨砂玻璃UI元素。当您构建叠加层、浮动控件、提示信息或任何应以半透明背景呈现的元素时,请使用此技能。

SKILL.md
--- frontmatter
name: glassmorphism
description: Creates frosted glass UI elements with blur, transparency, and subtle borders. Use when building overlays, floating controls, tooltips, or any element that should appear elevated with a translucent background.

Glassmorphism Pattern

Create frosted glass effects for overlays and floating UI elements.

Core Classes

tsx
// Standard glassmorphic container
<div className="bg-black/20 backdrop-blur-md border border-white/10">
  ...
</div>

Variations

Dark Overlay (on images/media)

Best for controls overlaid on images or video.

tsx
<div className="bg-black/20 backdrop-blur-md border border-white/10 rounded-full px-3 py-2">
  {/* Content */}
</div>

Light Overlay (on dark backgrounds)

tsx
<div className="bg-white/10 backdrop-blur-md border border-white/20 rounded-xl px-4 py-3">
  {/* Content */}
</div>

Subtle Glass (minimal effect)

tsx
<div className="bg-black/10 backdrop-blur-sm border border-white/5 rounded-lg px-3 py-2">
  {/* Content */}
</div>

Strong Glass (prominent effect)

tsx
<div className="bg-black/40 backdrop-blur-lg border border-white/20 rounded-2xl px-5 py-4">
  {/* Content */}
</div>

Token Reference

PropertyLight GlassStandardStrong
Backgroundbg-black/10bg-black/20bg-black/40
Blurbackdrop-blur-smbackdrop-blur-mdbackdrop-blur-lg
Borderborder-white/5border-white/10border-white/20

Common Use Cases

Carousel Indicators

tsx
<div className="absolute bottom-3 left-1/2 -translate-x-1/2">
  <div className="flex items-center gap-2 px-3 py-2 rounded-full bg-black/20 backdrop-blur-md border border-white/10">
    {/* Indicator dots */}
  </div>
</div>

Floating Action Button

tsx
<button className="fixed bottom-6 right-6 p-4 rounded-full bg-black/20 backdrop-blur-md border border-white/10 hover:bg-black/30 transition-colors">
  <Icon className="w-6 h-6 text-white" />
</button>

Tooltip/Popover

tsx
<div className="absolute top-full mt-2 px-3 py-2 rounded-lg bg-black/30 backdrop-blur-md border border-white/10">
  <span className="text-white text-sm">Tooltip content</span>
</div>

Navigation Bar (over hero)

tsx
<nav className="fixed top-0 left-0 right-0 z-50 bg-black/10 backdrop-blur-md border-b border-white/10">
  {/* Nav content */}
</nav>

Text Contrast

When using glassmorphism, ensure text has sufficient contrast:

Background OpacityText Color
bg-black/10 - bg-black/20text-white or text-white/90
bg-black/30 - bg-black/40text-white
bg-white/10 - bg-white/20text-white or text-zinc-100

Performance Note

backdrop-blur can impact performance on lower-end devices. Consider:

  • Using smaller blur values (backdrop-blur-sm) for frequently updated elements
  • Avoiding large glassmorphic areas that cover significant viewport
  • Testing on mobile devices

Checklist

  • Background has transparency (e.g., bg-black/20)
  • backdrop-blur-* applied for frosted effect
  • Subtle border with transparency (border-white/10)
  • Text has sufficient contrast
  • Border radius matches design language
  • Tested on lower-end devices for performance