Salt la conținutul principal

Prezentare generală

Utilizați ListItemButton pentru rânduri de acțiune și butoane de selectare independente. Combină aspectul ListItem cu un buton nativ, inclusiv activarea cu Enter și Spațiu, focalizarea și comportamentul dezactivat. Implicit, are type="button".

Utilizare

Acțiuni și stare dezactivată

Transmiteți direct onClick și disabled. Butoanele dezactivate folosesc aspectul corespunzător al rândului, împiedică activarea și ies din ordinea de tabulare.
Setați focusableWhenDisabled pentru a menține focalizabil un buton dezactivat. Folosește aria-disabled și continuă să blocheze activarea. Atributele, evenimentele, stilurile, numele de clase ale butonului nativ și o referință HTMLButtonElement ajung la buton. Evenimentele se propagă normal; apelanții furnizează orice politică pentru stopPropagation() sau preventDefault().

Selectare și sloturi vizuale

Aplicația dvs. gestionează independent stările active, selected și focused. Utilizați active pentru rândul deschis sau curent. Asociați selected cu starea accesibilă corespunzătoare, precum aria-pressed pentru un buton de comutare. focused evidențiază rândul fără a muta focalizarea DOM. Indicatorii și sugestiile pentru scurtături sunt decorative; aplicația dvs. înregistrează scurtăturile și gestionează navigarea.
Utilizați startIcon, endIcon, description și descriptionPlacement pentru conținut suplimentar. color="danger" marchează o acțiune distructivă. shortcutJoinLabel controlează textul dintre scurtăturile secvențiale, iar hasSubmenu afișează un indicator de submeniu.

Conținut de suport pe mai multe rânduri

Setați descriptionPlacement="below" pentru a încadra textul de suport sub etichetă. Eticheta își păstrează comportamentul de trunchiere. Transmiteți Text cu truncate sau lineClamp ca description atunci când aveți nevoie de o previzualizare mai scurtă. Poziționările inline și end își păstrează aspectul existent.
active aplică fundalul rândului curent. Setați selectionAppearance="accent" pentru o umplere de accent pe rândurile selectate, cu orice poziționare a descrierii; opțiunea implicită păstrează stilul existent de selecție bazat pe indicator. focused aplică fundalul evidențiat partajat; conturul vizibil la focalizare urmează focalizarea reală de la tastatură. Aceste proprietăți nu adaugă stare accesibilă și nu mută focalizarea. Activarea nativă a butonului și comportamentul dezactivat rămân neschimbate.

Comenzi independente

Păstrați butoanele și casetele de selectare independente lângă ListItemButton, astfel încât fiecare să își păstreze propria focalizare și activare. Nu le imbricați în sloturile sale de conținut sau de pictogramă. Componenta nu are un slot actions. Utilizați un ListItem cu rădăcina sa implicită div pentru un rând cu controale independente și asigurați comportamentul dezactivat și propagarea evenimentelor pentru fiecare control.
Utilizați ListItem pentru conținut pasiv, linkuri sau proprietari semantici personalizați. Folosește părțile de element existente Dropdown și Select în cadrul containerelor lor pop-up, care oferă roluri și navigare cu tastatura.

Proprietăți

boolean
Marks the open or current item independently of selection and focus. The caller supplies accessible state.
"danger" | "neutral"
Color of the text and icons. danger marks a destructive action.
ReactNode
Supporting text, placed according to descriptionPlacement.
"below" | "end" | "inline"
Places supporting content inline after the label, at the end, or below it with wrapping. Inline is the default.
boolean
implicit:"false"
Disables activation and applies the matching row appearance.
ReactNode
Icon rendered after the content.
boolean
implicit:"false"
Keeps a disabled button focusable with aria-disabled while preventing activation.
boolean
Highlights the row without moving DOM focus.
boolean
Displays a decorative submenu indicator.
"check" | "checkbox" | "none"
Selection indicator: a check icon after the content or a checkbox before it.
Ref<HTMLButtonElement>
Ref to the native HTMLButtonElement.
boolean
Applies selected styling and a decorative indicator. The caller supplies selection state and accessible semantics.
"accent" | "default"
Selection styling independent of description placement. default preserves indicator-based styling; accent fills selected rows with the accent background.
ShortcutDefinition
Displays decorative shortcut hints. The caller registers the shortcuts.
string
Text between sequential shortcut steps. Defaults to then; pass an empty string to omit it.
ReactNode
Icon rendered before the content.