Salt la conținutul principal

Prezentare generală

Utilizați Button pentru o acțiune și furnizați eticheta sa vizibilă ca elemente copil. Utilizați IconButton pentru controale numai cu pictograme, cu un nume accesibil din aria-label sau aria-labelledby. Pentru valori implicite recurente de design, utilizați MainButton sau LightButton din twenty-ui/components. Ambele partajează proprietățile native, referințele, starea și comportamentul de redare ale Button.

Utilizare

Aspect

Comparați separat variantele, culorile semantice, dimensiunile și stările obișnuite. Fiecare grup modifică o opțiune, păstrându-le pe celelalte neschimbate.
Alegeți solid, outline, soft, ghost sau link independent de culoarea neutral, accent, danger sau success. Dimensiunile sunt sm și md; valorile implicite sunt outline, neutral și md. fullWidth umple lățimea disponibilă. startIcon și endIcon acceptă elemente și sunt decorative. elevated adaugă o umbră și estomparea fundalului. Butoanele neutre cu contur primesc, de asemenea, o suprafață cu chenar, cu culori corespunzătoare pentru text și interacțiune. Alte variante și culori semantice își păstrează paleta existentă. Valoarea implicită este false și nu modifică dimensiunea sau poziția. shortcut afișează indicii de tastatură pe ecrane mai mari; asociați scurtăturile în aplicația dvs. Utilizați color="inherit" pentru controalele de pe o suprafață colorată. Eticheta, pictogramele, indicatorul de încărcare și conturul urmează culoarea textului din jur. Umplerile pentru interacțiune folosesc negru translucid. Butoanele cu contur se află pe o suprafață transparentă, cu un contur currentColor de 25%, și folosesc umpleri negre de 10% și 20% la trecerea cursorului și la apăsare. Ghost folosește umpleri negre transparente, de 10% și 20%; soft folosește 10%, 20% și 30%. Link rămâne neumplut. inherit acceptă outline, ghost, soft și link. O combinație rezolvată de solid și inherit generează o eroare în timpul rulării, inclusiv valorile implicite furnizate de ButtonGroup sau de un înveliș. MainButton are implicit varianta solid, deci furnizați o variantă care nu este solid atunci când moșteniți culoarea.
link utilizează text compact, fără chenar sau fundal umplut. Urmează înălțimea conținutului la ambele dimensiuni, cu un font mai mic și o spațiere interioară mai îngustă. Culoarea sa neutră utilizează un text mai pronunțat la trecerea cursorului. Aspectul nu determină semantica: utilizați onClick pentru acțiuni și href pentru navigare. disabled și loading împiedică activarea. Încărcarea menține eticheta accesibilă și comunică o stare de ocupare. În mod implicit, loadingPosition="center" ascunde conținutul, păstrând în același timp spațiul din aspectul său, și centrează indicatorul de încărcare. Setați loadingPosition la start sau end pentru a menține elementele copil și pictograma opusă vizibile, înlocuind în același timp pictograma corespunzătoare cu indicatorul de încărcare. Aplicația dvs. gestionează formatarea progresului și eticheta tradusă. Transmiteți expresia de stare completă ca elemente copil, de exemplu Installing (42%).

Proprietatea asupra stării

Button declanșează o acțiune și nu gestionează o valoare selectată, deci nu are un mod de selecție controlat sau necontrolat. Proprietatea sa nativă value furnizează date de formular, nu starea selecției. Aplicația dvs. gestionează loading și disabled, care au implicit valoarea false. Clicul pe un buton nu modifică aceste proprietăți și nu afișează automat încărcarea în timp ce rulează un gestionar asincron. Transmiteți explicit starea curentă a aplicației.
Aplicația inițiază și oprește încărcarea în jurul operației de salvare. Butonul împiedică activarea în timpul încărcării și devine din nou disponibil când operația se încheie, inclusiv după o eroare. MainButton și LightButton utilizează același model de stare.

Declanșatoare de popup

Compuneți un declanșator de popup cu Button, LightButton sau un alt wrapper pentru Button prin render. Declanșatorul furnizează data-popup-open, astfel încât butonul își păstrează fundalul la trecerea cursorului cât timp popupul este deschis și utilizează fundalul activ la trecerea cursorului sau la apăsare. Fiecare variantă și culoare își păstrează propria paletă. Fundalurile linkurilor rămân transparente, iar butoanele dezactivate sau în curs de încărcare își păstrează aspectul dezactivat. Butoanele cu aria-pressed="true" își păstrează stilul existent de comutare. Starea pop-upului nu setează aria-pressed și nu reprezintă o valoare selectată.

Funcții viitoare

Aplicația dvs. gestionează disponibilitatea funcției și eticheta acesteia. Compune un buton dezactivat cu Badge ca elemente copil, astfel încât eticheta să rămână parte din numele accesibil al butonului. Furnizați text localizat din aplicația dvs.
Această compoziție funcționează și cu MainButton și LightButton. Înlocuiește proprietățile soon și soonLabel eliminate.

Pictograme animate

Compuneți Button cu AnimatedIconCrossfade pentru a-i schimba pictograma când se modifică starea aplicației. Transmiteți elementul animat la startIcon și eticheta ca elemente copil.
Când o pictogramă este ea însăși o acțiune, utilizați IconButton sau LightIconButton și animați conținutul pictogramei. Când un antet de dezvăluire controlează extinderea, păstrați-i indicatorul chevron decorativ și expuneți aria-expanded pe controlul antetului. Păstrați stilurile de animație împreună cu funcționalitatea și respectați prefers-reduced-motion.

Linkuri și formulare

Fără un render personalizat, href redă o ancoră cu semantica unui link, cu excepția cazului în care setați explicit nativeButton la true. Atributele native ale ancorei, precum download, hrefLang, ping și referrerPolicy, ajung la ancoră. Proprietățile partajate cu butoanele native își păstrează tipurile Base UI. Pentru a furniza un tip MIME de ancoră, plasați-l pe renderer, de exemplu render={<a href="/records.csv" type="text/csv">Download records</a>} cu nativeButton={false} și role="link". Linkurile dezactivate și în curs de încărcare nu pot fi activate. Utilizați render pentru a compune un alt element sau un link de router. nativeButton descrie elementul redat și are implicit valoarea true pentru rendererele personalizate. Setați nativeButton={false} și role="link" pentru o ancoră de navigare. Componenta ancoră sau router poate deține destinația fără un href pentru Button.
Pentru un \<button> nativ personalizat, păstrați nativeButton la true. Pentru un element de acțiune non-nativ, cum ar fi un \<div>, utilizați nativeButton={false}; Base UI furnizează comportamentul de tastatură al butonului. Un nativeButton sau role explicit este păstrat chiar și atunci când este furnizat și href. Butoanele au implicit type="button". Setați explicit type="submit" sau type="reset" pentru formulare. Atributele native, gestionarele de evenimente, detaliile evenimentelor și referințele ajung la rădăcina redată. O referință primește butonul, ancora sau elementul rădăcină personalizat efectiv. Gestionarele de tastatură păstrează metodele de evenimente Base UI, inclusiv preventBaseUIHandler() pentru a anula acțiunea de tastatură integrată. Callbackul de redare al Base UI primește atât proprietățile rădăcinii, cât și starea curentă de dezactivare; distribuiți proprietățile pe rădăcina dvs. pentru a păstra comportamentul de compunere.

Valori implicite ale grupului

ButtonGroup furnizează o variantă, o culoare și o dimensiune partajate. O proprietate explicită a unui element copil are prioritate față de valoarea implicită a grupului. Atunci când niciuna nu setează o proprietate, se aplică valoarea implicită a componentei. Importați Button din twenty-ui/primitives/input și înlocuiți ClickToActionLink cu Button variant="link". Păstrați href, target și rel pentru navigare. Acțiunile fără href redau acum un buton nativ cu activare de la tastatură. Atributele, evenimentele și referințele native sunt transmise elementului rădăcină.

Proprietăți

string | ((state: ButtonState) => string | undefined)
CSS class applied to the element, or a function that returns a class based on the component’s state.
"accent" | "danger" | "inherit" | "neutral" | "success"
implicit:"neutral"
Semantic color of the button. inherit uses the surrounding text color for the label, icons, loader, and outline border, with translucent black interaction surfaces. It supports outline, ghost, soft, and link. Resolving solid with inherit throws, including appearance inherited from ButtonGroup and wrapper defaults.
boolean
implicit:"false"
Adds a shadow and backdrop blur. Neutral outline buttons also use elevated surface colors.
ReactNode
Decorative content displayed after the label.
boolean
implicit:"false"
Whether the button should be focusable when disabled.
boolean
implicit:"false"
Expands the button to fill its container width.
string
Destination URL. Renders a native anchor when render is omitted unless nativeButton is explicitly true. Custom renderers retain their own element contract.
boolean
implicit:"false"
Shows a loading indicator and disables activation.
"center" | "end" | "start"
implicit:"center"
Where the loading indicator appears. center hides the content while preserving its layout space; start and end keep children and the opposite icon visible and replace the corresponding icon with the spinner.
boolean
implicit:"true (false for the built-in href anchor)"
Whether the rendered root is a native button. Defaults to true for custom renderers. The built-in href anchor defaults to false; an explicit value takes precedence.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, ButtonState>
Caller-supplied root element or renderer. Native attributes, handlers, event details, and refs reach the rendered root. Use nativeButton={false} and role="link" for a custom navigation anchor. Router integration belongs to the caller.
AriaRole
Role of the root element. Use link for custom navigation renderers.
ShortcutDefinition
Flat key array for simultaneous keys, or nested key arrays for an ordered sequence. Displayed on non-mobile screens.
string
Localized text between sequence steps. Defaults to then.
"md" | "sm"
implicit:"md"
Button height: sm (24px) or md (32px). The link variant uses its content height at either size.
ReactNode
Decorative content displayed before the label.
CSSProperties | ((state: ButtonState) => CSSProperties | undefined)
Style applied to the element, or a function that returns a style object based on the component’s state.
"ghost" | "link" | "outline" | "soft" | "solid"
implicit:"outline"
Visual treatment of the button surface. link uses compact text styling without a filled surface or border; render composition determines native semantics.
Transmiteți shortcut={['Mod', 'Enter']} pentru taste simultane sau shortcut={[['G'], ['P']]} pentru apăsări succesive. Consultați Shortcut pentru combinații imbricate și formatorul de șiruri partajat.