ContextMenu
Na linha da tabela
import { ContextMenu } from '@rivocode/ui'Quando usar
O menu do botão direito.
O conteúdo é o mesmo do Menu: use MenuContent, MenuItem, MenuGroup e
MenuSeparator dentro dele. Só o gatilho muda, porque aqui quem abre é a área
inteira, e não um botão.
No React Native o mesmo caso existe, e o gesto muda: o Menu do
@rivocode/ui-native abre no toque longo da área que você passar como
children. A seção do fim desta página diz como.
<ContextMenu>
<ContextMenuTrigger className="rounded-md border border-dashed p-6">
Clique com o botão direito
</ContextMenuTrigger>
<MenuContent>
<MenuItem>Baixar PDF</MenuItem>
<MenuItem>Duplicar</MenuItem>
<MenuSeparator />
<MenuItem tone="danger">Excluir arquivo</MenuItem>
</MenuContent>
</ContextMenu>
Quando não usar
Nunca como o único caminho para uma ação: no toque não existe botão direito, e
nem todo teclado tem a tecla de menu. O Menu da linha, no botão de três
pontinhos, continua existindo, e este só acelera o que já está nele.
O que a área inteira faz no clique simples, como abrir o detalhe, não é menu: é
Link ou Button.
No React Native
Vira Menu, e não peça nova: o menu do botão direito é, no celular, o toque longo, e quem abre a folha de ações já é o Menu. Passe a área alvo como children dele — o que no web é o ContextMenuTrigger — e ela chama onOpenChange(true) no toque longo, com classNames.trigger para o layout que os filhos exigem. Quem navega por leitor de tela entra pela mesma porta: a área expõe a ação longpress, que o VoiceOver e o TalkBack oferecem no menu de ações, então o gesto nunca é o único caminho.
API
| Prop | Tipo | Padrão |
|---|---|---|
actionsRef0.4.0Uma ref para as ações imperativas. | RefObject<MenuRootActions | null> | sem padrão |
closeParentOnEsc0.4.0 | boolean | sem padrão |
defaultOpen0.4.0Se o menu começa aberto. | boolean | false |
disabled0.4.0Se a peça deve ignorar a interação do usuário. | boolean | false |
highlightItemOnHover0.4.0Se passar o ponteiro sobre os itens os destaca. | boolean | true |
loopFocus0.4.0Se o foco do teclado volta ao primeiro item ao chegar no fim da lista pelas setas. | boolean | true |
onItemHighlightedChamado quando um item ganha ou perde o destaque. | ((highlightedItem: HTMLElement | undefined, eventDetails: MenuRootHighlightEventDetails) => void) | sem padrão |
onOpenChange0.4.0Chamado quando o menu abre ou fecha. | ((open: boolean, eventDetails: ContextMenuRootChangeEventDetails) => void) | sem padrão |
onOpenChangeComplete0.4.0Chamado depois que as animações terminam, quando o menu abre ou fecha. | ((open: boolean) => void) | sem padrão |
open0.4.0Se o menu está aberto agora. | boolean | sem padrão |
orientation0.4.0A orientação visual do menu. | MenuRootOrientation | "vertical" |