ब्लॉग

Liquid Glass Designडेव2 मिनट में पढ़ें

Liquid Glass components for React: shadcn से इंस्टॉल करें

Liquid Glass components for React: 38 ओपन-सोर्स Base UI कंपोनेंट, जो हर आधुनिक ब्राउज़र में अपवर्तन करते हैं और shadcn CLI से इंस्टॉल होते हैं।

Liquid Glass components for React: shadcn से इंस्टॉल करें
इस पेज पर
  1. आपको क्या मिलता है
  2. shadcn से Liquid Glass कंपोनेंट इंस्टॉल करें
  3. ग्लास को मोड़ने के लिए कुछ दें
  4. Liquid Glass UI कंपोनेंट में से कौन-से ग्लास हैं
  5. iOS जैसा तैरता टैब बार
  6. Safari और Firefox
  7. थीमिंग
  8. परफ़ॉर्मेंस
  9. कब कुछ और इस्तेमाल करें
  10. स्रोत

React ऐप में Liquid Glass कंपोनेंट लाने का सबसे तेज़ तरीक़ा shadcn का एक कमांड है: npx shadcn@latest add https://liqui.design/r/button.json। यह Liqui से एक बटन इंस्टॉल करता है। Liqui, Base UI पर बने 38 ग्लास कंपोनेंट का सेट है, जो Chromium, Safari और Firefox में बिना WebGL के अपने पीछे के पेज को मोड़ते हैं।

Liqui हमारा अपना प्रोजेक्ट है। यह इसी गैलरी से निकला है, MIT लाइसेंस के तहत है, और इसका सोर्स GitHub पर है। इसकी सीमाएँ आख़िरी सेक्शन में दी गई हैं, ताकि आप देख सकें कि यह आपके प्रोजेक्ट में चल पाएगा या नहीं।

आपको क्या मिलता है

लाइब्रेरी में 38 कंपोनेंट हैं: बटन, मेन्यू, सिलेक्ट, डायलॉग, एक ड्रॉअर, स्लाइडर, स्विच, टैब, टोस्ट, iOS जैसा तैरता टैब बार, और इनके साथ लगने वाले फ़ॉर्म कंट्रोल। हर कंपोनेंट एक Base UI primitive है जिसके नीचे ग्लास की सतह है, इसलिए फ़ोकस हैंडलिंग, कीबोर्ड सपोर्ट और ARIA, Base UI से आते हैं।

ये कंपोनेंट उसी तरह आते हैं जैसे shadcn/ui के कंपोनेंट। CLI कंपोनेंट फ़ाइल को सादे TSX के रूप में आपकी रिपॉज़िटरी में लिख देता है, और आप उसे किसी भी दूसरी फ़ाइल की तरह एडिट करते हैं। dependency के रूप में सिर्फ़ अपवर्तन का kernel बचता है, यानी npm पैकेज @liqui-design/glass। इसमें डिस्प्लेसमेंट मैप का गणित, एक साझा SVG फ़िल्टर रजिस्ट्री और ब्राउज़र फ़ॉलबैक हैं, यानी वह कोड जिसे आप हाथ से मेंटेन नहीं करना चाहेंगे।

Liqui होम पेज का डेमो: रेगिस्तान की फ़ोटो पर macOS कंट्रोल सेंटर जैसे ग्लास पैनल, और बगल में refraction, bezel और frost स्लाइडर वाला Optics पैनल
Liqui होम पेज का डेमो, Chromium में लिया गया स्क्रीनशॉट। liqui.design खोलें

shadcn से Liquid Glass कंपोनेंट इंस्टॉल करें

आपको React 18 या 19 और Tailwind CSS v4 चाहिए। Liqui वही Base UI बेस इस्तेमाल करता है जो shadcn/ui करता है (shadcn init -b base), इसलिए आपका मौजूदा components.json, cn() हेल्पर और टोकन सेटअप वैसे ही काम करते रहते हैं।

URL से एक कंपोनेंट जोड़ें:

Terminal
npx shadcn@latest add https://liqui.design/r/button.json

यह components/ui/button.tsx लिखता है, आपकी globals.css में ग्लास टोकन जोड़ता है और @liqui-design/glass इंस्टॉल करता है। अगर आप कई कंपोनेंट जोड़ने वाले हैं, तो components.json में namespace एक बार रजिस्टर कर दें:

JSON
{
  "registries": {
    "@liqui-design": "https://liqui.design/r/{name}.json"
  }
}
Terminal
npx shadcn@latest add @liqui-design/button @liqui-design/select

@liqui-design/button एक रजिस्ट्री आइटम है, जिसे shadcn CLI रिज़ॉल्व करता है। npm i @liqui-design/button फ़ेल हो जाएगा, क्योंकि npm पर पब्लिश हुआ अकेला पैकेज @liqui-design/glass है, और उसे CLI आपके लिए इंस्टॉल कर देता है।

इस्तेमाल करना किसी भी shadcn कंपोनेंट जैसा ही है:

TSX
import { Button } from '@/components/ui/button';

export default function Page() {
  return (
    <main className="min-h-dvh bg-[url(/wallpaper.jpg)] bg-cover p-10">
      <Button>Skip</Button>
      <Button variant="accent">Continue</Button>
    </main>
  );
}

ग्लास को मोड़ने के लिए कुछ दें

उन बटनों के पीछे का वॉलपेपर देखें। सपाट रंग के ऊपर रखा लेंस आपको वही सपाट रंग दिखाता है, इसलिए सादे सफ़ेद पेज पर ग्लास बटन हल्के ग्रे बॉक्स जैसा दिखता है, और इसे आसानी से बग समझा जा सकता है। ग्लास को फ़ोटोग्राफ़ी, वीडियो, तीखे किनारों वाले ग्रेडिएंट, या नीचे स्क्रोल होते कॉन्टेंट के ऊपर रखें। अगर डिज़ाइन सच में सपाट रंग पर है, तो material="clear" सेट करें और टिंट पर भरोसा करें।

काला स्पीकर पकड़े हाथ की क्लोज़-अप फ़ोटो के ऊपर तैरता, 52 पर सेट ग्लास वॉल्यूम स्लाइडर और एक गोल AirPlay बटन
Liquid Glass - Slider Concept(Volume), sanoj sunny द्वारा। गैलरी में देखें

sanoj sunny का स्लाइडर कॉन्सेप्ट उस सेटअप की अच्छी तस्वीर है जो यह मटीरियल चाहता है: कंट्रोल के पीछे मज़बूत आकारों और कंट्रास्ट वाली फ़ोटो, ताकि ग्लास के पास काम करने के लिए किनारे हों। मुड़ाव रिम पर ही क्यों होता है, यह हमारे Liquid Glass क्या है वाले लेख में है।

Liquid Glass UI कंपोनेंट में से कौन-से ग्लास हैं

Liqui वही रेखा मानता है जो Apple खींचता है। ग्लास उस सतह के लिए है जिसके ज़रिए आप कोई काम करते हैं, और ठोस फ़िल उस कंट्रोल के लिए है जिसमें कोई वैल्यू होती है।

  • बटन, पॉपअप, मेन्यू, टूलबार, शीट और डायलॉग ग्लास हैं। ये आपके कॉन्टेंट के ऊपर तैरते हैं, और उस कॉन्टेंट को आर-पार दिखने देना ही इस मटीरियल का मक़सद है।
  • Checkbox, Radio, Toggle और Switch सपाट हैं। सामान्य स्थिति में ये बाल जितनी पतली लाइन के साथ --lq-control इस्तेमाल करते हैं, और चालू होने पर --lq-accent।
  • Button दोनों तरफ़ आता है। डिफ़ॉल्ट variant ग्लास है। accent और danger ठोस फ़िल हैं, क्योंकि टिंट वाला लेंस अपने पीछे की चीज़ के साथ रंग बदलता है, और जो ब्रांड कलर रात की फ़ोटो पर और चमकीली फ़ोटो पर अलग-अलग दिखे, वह अपना काम नहीं कर पाता।

अपने डिज़ाइनों पर भी यही जाँच काम करती है: अगर आपका मन किसी चेकबॉक्स को ग्लास से बनाने का है, तो पूछें कि यूज़र उससे क्या पढ़ता है। अगर जवाब "चालू या बंद" है, तो उसे ठोस बनाएँ।

iOS जैसा तैरता टैब बार

Tab Bar, iOS 26 के तैरते टैब बार की नकल है। यह पेज के ऊपर तैरता है, अपने नीचे स्क्रोल होती लिस्ट को मोड़ता है, और टैब दबाने पर आपकी उँगली के नीचे एक दूसरा लेंस रख देता है।

Terminal
npx shadcn@latest add https://liqui.design/r/tab-bar.json
TSX
'use client';
import { useState } from 'react';
import { Heart, House } from 'lucide-react';
import { TabBar, TabBarItem } from '@/components/ui/tab-bar';

export function BottomBar() {
  const [tab, setTab] = useState('home');
  return (
    <TabBar value={tab} onValueChange={setTab}>
      <TabBarItem value="home" icon={<House fill="currentColor" strokeWidth={0} />}>Home</TabBarItem>
      <TabBarItem value="saved" icon={<Heart fill="currentColor" strokeWidth={0} />} badge={3}>Saved</TabBarItem>
    </TabBar>
  );
}

यह कैसा दिखेगा, यह frost तय करता है। frost ब्लर और टिंट को एक साथ बढ़ाता है, और ब्लर ही किसी लेंस के अंदर रखे दूसरे लेंस को बेकार करता है, क्योंकि अंदर वाला पिल किनारों को मोड़ पाए, उससे पहले ही ब्लर उन्हें मिटा देता है। डॉक्यूमेंटेशन इस समझौते को क़दम-दर-क़दम समझाता है: frost 0.35 पर लेबल ठीक से पढ़े जाते हैं पर सिलेक्शन पिल एक धब्बा बन जाता है, 0 पर पिल काम करता है पर पेज सीधे लेबल के आर-पार दिखने लगता है, और बार 0.16 के साथ आता है।

iPhone स्क्रीन का निचला हिस्सा, जिसमें मैसेज की सूची के ऊपर तैरता पारभासी टैब बार है: Dashboard, Inbox, Scan, Customer और More
Liquid Glass Mobile app Navbar, Mahdi Sourabh द्वारा। गैलरी में देखें

Mahdi Sourabh का नेवबार कॉन्सेप्ट यही संतुलन डिज़ाइन की तरफ़ से दिखाता है: स्क्रोल होती सूची के ऊपर एक हल्का पैनल, जिसके लेबल नीचे से पंक्तियाँ गुज़रने पर भी पढ़ने लायक़ रहते हैं।

Safari और Firefox

वेब पर अपवर्तन backdrop-filter: url(#filter) से होता है, और नवंबर 2026 तक इसे सिर्फ़ Chromium ड्रॉ करता है। जब backdrop-filter की वैल्यू किसी SVG फ़िल्टर का हवाला देती है, तो Safari पूरी वैल्यू छोड़ देता है, और Firefox उसे अनदेखा करता है। WebKit बग 245510 के पैच रिव्यू में हैं, पर बग अब भी खुला है। ब्राउज़र से जुड़ी बारीकियाँ हमारी CSS और SVG गाइड में हैं।

किसी एलिमेंट के अपने कॉन्टेंट पर SVG फ़िल्टर दोनों इंजन ड्रॉ करते हैं। Liqui इसी का इस्तेमाल करता है: किसी हिस्से को LiquiBackdrop में लपेटें, और जब पेज को ख़ुद नहीं मोड़ा जा सकता, तब उसके अंदर की हर ग्लास सतह उस बैकड्रॉप की एक कॉपी को मोड़ती है।

TSX
import { LiquiBackdrop, LiquiGlass } from '@liqui-design/glass';

<LiquiBackdrop
  backdrop={<img src="/wallpaper.jpg" className="absolute inset-0 size-full object-cover" />}
>
  <LiquiGlass radius={20}>…</LiquiGlass>
</LiquiBackdrop>

हर सतह माउंट होते समय एक रेंडरिंग टियर चुनती है, और इसके लिए कुछ कॉन्फ़िगर नहीं करना पड़ता:

  1. बैकड्रॉप अपवर्तन: सतह के पीछे का लाइव पेज, डिस्प्लेस किया हुआ। सिर्फ़ Chromium।
  2. कॉपी अपवर्तन: पहले से पता बैकड्रॉप की एक कॉपी, डिस्प्लेस की हुई। LiquiBackdrop के अंदर Safari और Firefox।
  3. फ़्रॉस्ट: ब्लर, टिंट और पहले से बेक की हुई किनारे की रोशनी। बाक़ी सब जगह।
  4. Clear: टिंट और रिम, बिना बैकड्रॉप फ़िल्टर के, जब आप material="clear" माँगते हैं।

कॉपी सिर्फ़ उन सतहों के लिए काम करती है जो सीधे बैकड्रॉप पर रखी हैं। किसी दूसरी सतह के अंदर रखी सतह, या बॉक्स से बाहर portal की गई पॉपअप, फ़्रॉस्ट पर लौट आती है और उसका रिम बना रहता है। इसलिए अपना UI Safari में जाँचें: frost: 0 पर ट्यून की गई सतह फ़्रॉस्ट टियर पर पढ़ने में मुश्किल हो सकती है, क्योंकि जो काम लेंस कर रहा था, वह अब टिंट को अकेले करना पड़ता है। उस समय कौन-सी कंट्रास्ट जाँचें चलानी चाहिए, यह एक्सेसिबिलिटी गाइड में है।

थीमिंग

रंग चौदह --lq-* कस्टम प्रॉपर्टी से तय होते हैं, जिन्हें CLI globals.css में लिखता है। वहाँ --lq-accent या --lq-tint बदलें, और हर कंपोनेंट उसके हिसाब से बदल जाता है, document.body में portal की गई पॉपअप भी। डार्क मोड .dark और [data-theme='dark'] दोनों से चालू होता है, इसलिए ओवरराइड दोनों के नीचे लिखें।

ऑप्टिक्स CSS वेरिएबल नहीं हो सकते, क्योंकि वे canvas से बने मैप और एक SVG फ़िल्टर को इनपुट देते हैं। इसलिए वे LiquiThemeProvider के ज़रिए आते हैं। ज़्यादातर डायल (frost, finish, dispersion) डिफ़ॉल्ट वैल्यू हैं जिन्हें कोई कंपोनेंट ओवरराइड कर सकता है, जबकि radiusScale, refractionScale, bezelScale और blurScale हर कंपोनेंट की अपनी वैल्यू को गुणा करते हैं। तब मोटा ग्लास माँगने पर स्क्रॉलबार का थंब और ड्रॉअर, दोनों अनुपात में मोटे होते हैं; एक ही ग्लोबल अपवर्तन वैल्यू थंब को धब्बा बना देती।

TSX
<LiquiThemeProvider theme={{ glass: { frost: 0.2, refractionScale: 1.25 } }}>
  {children}
</LiquiThemeProvider>

थीम एडिटर डायल से दोनों हिस्से सेट करता है और CSS तथा provider का कोड एक्सपोर्ट करता है। यह आपकी थीम ब्राउज़र में रखता है और सिर्फ़ वही एक्सपोर्ट करता है जो आपने बदला है।

परफ़ॉर्मेंस

महँगे हिस्से डिस्प्लेसमेंट मैप और backdrop-filter की चेन हैं। मैप canvas पर एक बार बनते हैं और साइज़ तथा ऑप्टिक्स के हिसाब से कैश होते हैं, इसलिए एक ही साइज़ के दस बटन एक ही मैप साझा करते हैं। फ़िल्टर एक छिपी हुई SVG रजिस्ट्री में रहते हैं, इसी वजह से कोई मेन्यू दोबारा खुलने पर पहले फ़्रेम से ही अपवर्तन करता है। दो चीज़ें फिर भी फ़्रेम खाएँगी: 0 से ऊपर का dispersion फ़िल्टर का काम लगभग तीन गुना कर देता है, और एक स्क्रीन पर बैकड्रॉप फ़िल्टर वाली दर्जन भर बड़ी सतहें एक बड़ी सतह से ज़्यादा महँगी पड़ती हैं।

कब कुछ और इस्तेमाल करें

Liqui सिर्फ़ React के लिए है और इसे Tailwind v4 चाहिए, इसलिए यह किसी Vue ऐप या Tailwind 3 प्रोजेक्ट में सीधे नहीं लगेगा। Safari में किसी भी लाइव कॉन्टेंट के ऊपर अपवर्तन तब तक कोई लाइब्रेरी नहीं कर सकती, जब तक WebKit फ़िक्स शिप नहीं करता। अगर आपको बिना किसी कंपोनेंट सिस्टम के बस एक ग्लास पैनल चाहिए, तो सादे CSS और SVG वाले तरीक़े में कम कोड ढोना पड़ता है। दूसरे विकल्प और उनमें से हर एक कैसे रेंडर करता है, यह हमारी Liquid Glass React लाइब्रेरी की तुलना में है।

अगर आप पहले कंपोनेंट देखना चाहते हैं, तो डॉक्यूमेंटेशन हर कंपोनेंट को असली बैकड्रॉप पर दिखाता है, और Media Player टेम्पलेट npx shadcn@latest add https://liqui.design/r/media-player.json से पूरी स्क्रीन इंस्टॉल कर देता है। डिज़ाइन के रेफ़रेंस चाहिए, तो गैलरी के UI सेक्शन में Dribbble और दूसरी जगहों के डिज़ाइनरों के Liquid Glass इंटरफ़ेस इकट्ठा हैं।

वर्ज़न, सेटिंग्स और आँकड़े 20 नवंबर 2026 को जाँचे गए (@liqui-design/glass 0.8.0)।

स्रोत

यह लेख शेयर करें

हर हफ़्ते, नए संदर्भ

चुनिंदा Liquid Glass काम, हर एक के पीछे की तकनीक के साथ।

हफ़्ते में एक ईमेल, अंग्रेज़ी में। एक क्लिक में अनसब्सक्राइब।