Skip to main content
Frosted UI er Whops omfattende React-komponentbibliotek og designsystem. Det indeholder mere end 60 komponenter, der overholder standarder for tilgængelighed. Det indeholder også et avanceret farvesystem, en typografiskala og problemfri understøttelse af mørk tilstand – alt sammen bygget på Radix UI-primitiver og Tailwind CSS.

Installation

1

Installér pakken

Pakken @whop/react indeholder Frosted UI og alle nødvendige afhængigheder.
2

Opsæt WhopApp-provideren

Omslut din applikation med WhopApp-komponenten i dit rodlayout. Det opsætter temaet og iframe-SDK’et.
3

Konfigurer Next.js (valgfrit)

Brug withWhopAppConfig-wrapperen i din Next.js-konfiguration:
Det konfigurerer server actions og optimerer Frosted UI-imports.
4

Opsæt Tailwind (valgfrit)

Hvis du bruger Tailwind CSS, skal du tilføje Frosted UI-pluginnet for at få adgang til design tokens:
Frosted UI er nu sat op og klar til brug.

Typografi

Frosted UI har et omfattende typografisystem med to hovedkomponenter: Heading og Text.

Typeskala

Begge komponenter bruger en størrelsesskala med 10 trin (0-9):

Text-komponenten

Props:
  • size: "0" through "9" (default: "3")
  • weight: "light" | "regular" | "medium" | "bold"
  • align: "left" | "center" | "right"
  • color: Enhver accentfarve eller "gray"
  • highContrast: Øger kontrasten af hensyn til tilgængelighed
  • as: "span" | "div" | "p" | "label"

Heading-komponenten

Props:
  • size: "0" through "9" (default: "6")
  • weight: "light" | "regular" | "medium" | "bold"
  • align: "left" | "center" | "right"
  • as: "h1" | "h2" | "h3" | "h4" | "h5" | "h6"
  • color: Enhver accentfarve eller "gray"
  • highContrast: Øger kontrasten af hensyn til tilgængelighed

Andre typografikomponenter


Farver

Frosted UI bruger Radix-farveskalaer, som giver farvepaletter med 12 trin i både solide varianter og alpha-varianter.

Accentfarver

Der er 27 tilgængelige accentfarver: Almindelige farver: tomato, red, ruby, crimson, pink, plum, purple, violet, iris, indigo, blue, cyan, teal, jade, green, grass, brown, orange Klare farver: sky, mint, lime, yellow, amber, lemon, magenta Metalliske farver: gold, bronze

Grå farver

6 gråskalaer med forskellige farvetemperaturer:
  • gray - Ren neutral grå
  • mauve - Let lillatonet
  • slate - Kølig blåtonet
  • sage - Diskret grøntonet
  • olive - Varm olivental
  • sand - Varm sandtonet
  • auto - Matcher automatisk accentfarven

Semantiske farver

Forudkonfigurerede farver til almindelige formål:
  • Fare: red (standard), tomato, ruby
  • Advarsel: amber (standard), yellow
  • Succes: green (standard), teal, jade, grass
  • Info: sky (standard), blue

Brug af farver

Tailwind-farveklasser

Med Tailwind-pluginnet kan du bruge Frosted UI-farver direkte:
Farveskala:
  • Trin 1-3: Baggrunde og diskrete udfyldninger
  • Trin 4-6: Kanter og separatorer
  • Trin 7-9: Interaktive elementer
  • Trin 10-12: Tekst og elementer med høj kontrast
Alpha-varianter:
  • Brug {color}-a1 til {color}-a12 til gennemsigtighed
Når frostedUiPlugin() er tilføjet til din Tailwind-konfiguration, virker Tailwinds standardfarver som bg-blue-200 ikke. Brug i stedet bg-blue-2 ifølge dokumentationen ovenfor.

Mørk tilstand

Frosted UI har automatisk understøttelse af mørk tilstand, der respekterer systemindstillinger og brugerens valg.

Sådan virker det

Styr mørk tilstand med tre visningstilstande:
  • "inherit" (standard) - Respekterer systemindstillingen
  • "light" - Gennemtvinger lys tilstand
  • "dark" - Gennemtvinger mørk tilstand
Browseren gemmer temavalget i en cookie (whop-frosted-theme) og falder tilbage til systemindstillingen, når der ikke findes en.

Konfiguration

Konfigurer udseendet i din WhopApp-komponent:
Eller opret indlejrede temaer med forskellige udseender:

Tailwind-klasser til mørk tilstand

Brug præfikset dark: til styles i mørk tilstand:

Breakpoints

Frosted UI bruger et mobile-first responsivt system med 5 breakpoints.

Breakpoint-skala

Responsive props

Mange komponenter understøtter responsive værdier med en objektsyntaks:

Responsive Tailwind-klasser


Ikoner

Frosted UI har et ikonsystem via pakken @frosted-ui/icons.

Brug af ikoner

Almindelige ikoner

Frosted UI bruger Radix Icons, som indeholder ikoner som:
  • Navigation: ChevronRightIcon, ChevronDownIcon, ArrowRightIcon
  • Handlinger: Cross2Icon, CheckIcon, PlusIcon, MinusIcon
  • UI: MagnifyingGlassIcon, GearIcon, PersonIcon
  • Flere ikoner er tilgængelige i biblioteket.

Tailwind-plugin

Frosted UI’s Tailwind-plugin stiller design tokens til rådighed som Tailwind-utilities.

Hvad er inkluderet

Typografi:
Farver:
Afstand og layout:

Vigtige forskelle fra standard-Tailwind

  1. Skala for skriftstørrelse: Bruger 0-9 i stedet for xs/sm/base/lg
  2. Skala for linjehøjde: Matcher skalaen for skriftstørrelse (0-9)
  3. Farvesystem: Radix-farveskalaer med 12 trin og alpha-varianter
  4. Semantiske farver: Indbyggede farver til fare, advarsel, succes og info
  5. Design tokens: Alle værdier bruger CSS-variabler for ensartede temaer

Almindelige komponenter

Button

Props:
  • size: "1" | "2" | "3" | "4"
  • variant: "solid" | "soft" | "surface" | "ghost" | "classic"
  • color: Enhver accentfarve
  • highContrast: Forøget kontrast
  • loading: Viser en indlæsningsindikator
  • disabled: Deaktiverer interaktion

Input

Card

Badge

Dialog

Select

Checkbox og radio


Avanceret brug

Tilpasning af tema

Tilpas temaet med flere indstillinger:

Indlejrede temaer

Opret sektioner med forskellige temaer:

Adgang til temakonteksten


Komponentbibliotek

Frosted UI indeholder over 60 komponenter organiseret efter kategori: Layout: Box, Flex, Grid, Container, Section, AspectRatio, Inset Typografi: Heading, Text, Code, Strong, Em, Kbd, Quote, Blockquote Formularer: TextInput, TextArea, Checkbox, RadioGroup, Select, Switch, Slider, DatePicker, OTPField Knapper: Button, IconButton Visning: Card, Avatar, AvatarGroup, Badge, Callout, Table, DataList, Skeleton Navigation: Tabs, Breadcrumbs, Link, SegmentedControl Overlejring: Dialog, AlertDialog, Drawer, Sheet, Popover, HoverCard, Tooltip, DropdownMenu, ContextMenu Feedback: Progress, CircularProgress, Spinner Værktøjer: ScrollArea, Separator, Portal, VisuallyHidden, AccessibleIcon
Alle komponenter er bygget på Radix UI-primitiver og følger bedste praksis for tilgængelighed.

Ressourcer