Prezentare generală
Componentele Twenty UI citesc proprietăți personalizate CSS publice prefixate cu--t-. Preferați tokenuri semantice precum background.secondary și font.color.primary atunci când stilizați propriile componente; aceste valori se adaptează la paleta activă.
Utilizați tokenuri în stiluri
themeCssVariables mapează căile tokenurilor la referințe de variabile CSS. Utilizați-l pentru valori pe care CSS le rezolvă:
Citiți valorile rezolvate
useTheme() citește tokenurile calculate ale furnizorului activ. Utilizați-l atunci când o componentă așteaptă un număr JavaScript, cum ar fi dimensiunea unei pictograme. Furnizorul are nevoie ca foaia de stil a temei să fie încărcată în browser pentru a rezolva variabilele CSS.
themeCssVariables este un șir de referință CSS, inclusiv tokenurile numerice. Nu efectuați operații aritmetice asupra acelor șiruri. Pe server, valorile rezolvate din browser nu sunt disponibile; consultați randarea pe server.
Limitați domeniul unei suprascrieri
TransmitețiapplyToRoot={false} pentru a aplica o temă unui subarbore. Suprascrieți variabilele CSS publice folosind numele lor complet:
display: contents; acesta nu creează o casetă de aspect. De asemenea, furnizează un container pentru componentele care acceptă portaluri tematice. Portalurile create de alte biblioteci au nevoie de propria configurație de container.
Variabilele prefixate cu --tw- sunt detalii private ale componentelor. Utilizați proprietăți publice și tokenuri --t- în loc să depindeți de acele variabile.
Consultați referința tokenurilor pentru numele disponibile și valorile paletei.
Valori explicite și scală
Proprietateatheme furnizează valori JavaScript ale temei rezolvate, în loc să citească stilurile calculate. De asemenea, se propagă la furnizorii imbricați, cu excepția cazului în care aceștia furnizează o altă temă explicită. Aceasta modifică valorile citite de hook-uri; încărcați foaia de stiluri corespunzătoare și utilizați suprascrieri CSS pentru a stiliza componentele.
scale scrie --t-scale-user în rădăcina documentului. Afectează numai interfețele al căror CSS utilizează acea variabilă și este ignorată de furnizorii cu domeniu de aplicare. className se aplică unui înveliș cu domeniu de aplicare; transmiterea sa singură nu creează un înveliș. overrides creează un domeniu de aplicare chiar și atunci când applyToRoot rămâne true.
Proprietățile ThemeProvider
boolean
implicit:"true"
Applies the color-scheme class to the document root. Set false for a scoped wrapper.
ReactNode
obligatoriu
Components that share this theme.
string
Class applied to a scoped wrapper; no wrapper is created for className alone.
"dark" | "light"
obligatoriu
Explicit light or dark palette; load its stylesheet before rendering.
ThemeOverrides
CSS custom-property overrides. Supplying them creates a scoped wrapper.
number
Root interface scale stored in —t-scale-user. Ignored for scoped providers; application CSS must consume the variable.
ThemeType | typeof THEME_LIGHT
Explicit resolved theme values, bypassing computed-style token resolution.