Navegar componentes
← ComponentesUm item de menu marcável (role="menuitemcheckbox") que alterna um boolean independente. Use para opções on/off dentro de um DropdownMenu; para escolha one-of-N use DropdownMenuRadioGroup.
DropdownMenuCheckboxItem
MiscExemploExemplos
Área interativa
isDisabled
hasCloseOnSelect
Props
| Prop | Tipo | Padrão | Descrição |
|---|---|---|---|
label | ReactNode | — | Texto do label principal que identifica o item. |
description | ReactNode | — | Texto de descrição secundário exibido abaixo do label. |
icon | IconType | — | Ícone a exibir antes do label. Veja `npx pharos docs icons` para nomes semânticos válidos. |
value | boolean | — | Se o item está marcado. Controlado; combine com onChange. |
onChange | (checked: boolean) => void | — | Callback disparado com o próximo estado checked quando o item é alternado. |
isDisabled | boolean | false | Se o item está desabilitado. Itens desabilitados permanecem focáveis (via aria-disabled) para serem descobertos por teclado e tecnologias assistivas, mas a ativação é bloqueada. |
hasCloseOnSelect | boolean | false | Se alternar o item fecha o menu. Itens checkbox permanecem abertos por padrão para que vários possam ser alternados em uma única sessão. |
endContent | ReactNode | — | Conteúdo a renderizar após o label e description, como uma dica de atalho de teclado ou badge. |