Prezentare generală
FoloseșteTabButton pentru linkuri de rută și acțiuni precum adăugarea unei file sau deschiderea unui meniu de opțiuni suplimentare. Are aspectul Tabs și folosește Button pentru interacțiune.
Utilizare
Stare și semantică
Aplicația ta furnizeazăactive din starea curentă a rutei sau a meniului. Această proprietate evidențiază controlul. Setează aria-current="page" pe linkul rutei curente. Linkurile de rută și acțiunile adiacente își păstrează semantica de link sau de buton, fără rol de filă, aria-selected sau relație cu panoul.
Utilizați Tabs.Root, Tabs.List, Tabs.Tab, Tabs.Panel și opționalul Tabs.Indicator pentru a comuta între panouri de conținut asociate. Păstrați comenzile de rută și de acțiune în afara Tabs.List.
Navigare
Setațihref pentru a reda un link nativ. Ruta curentă deține aspectul său active și valoarea aria-current.
render, setați nativeButton={false} și role="link" și transmiteți destinația rezolvată ca href. Păstrează opțiunile de stare și istoric ale rutei pe linkul routerului. Învelișurile personalizate trebuie să redirecționeze proprietățile furnizate și referința către ancora lor.
nativeButton explicit controlează contractul de interacțiune chiar și atunci când este prezent href. Potriviți-l cu elementul redat efectiv. Linkurile dezactivate își păstrează rolul de link și blochează activarea.
Acțiuni
Fărăhref, controlul redă un buton nativ cu type="button". Atributele native, referințele, stilurile, numele claselor și gestionarii de evenimente sunt transmise mai departe. render acceptă un element sau o funcție care primește proprietățile și starea Button. Referințele indică butonul sau ancora redată efectiv, inclusiv referințele furnizate pe un element compus.
startIcon, endIcon și badge pentru conținut auxiliar. Un avatar transmis într-un slot de pictogramă este decorativ atunci când textul denumește destinația. size păstrează contractul public pentru dimensiunea Button. O dimensiune explicită are prioritate față de dimensiunea unui ButtonGroup înconjurător; în caz contrar, componenta folosește implicit sm.
Proprietăți
boolean
implicit:"false"
Highlights the current destination or an action associated with the active tab. Does not change the control role.
ReactNode
Content following the label and trailing icon, such as a count.
string | ((state: ButtonState) => string | undefined)
CSS class applied to the element, or a function that
returns a class based on the component’s state.
ReactNode
Decorative content displayed after the label.
boolean
implicit:"false"
Whether the button should be focusable when disabled.
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:"true"
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."md" | "sm"
implicit:"sm"
Padding of the tab content: sm or md. Explicit size takes precedence over the ButtonGroup size, then sm applies.
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.