Pular para o conteúdo
Sobreposição

ContextMenu

/componentes/context-menu.mdmarkdown cru, para quem lê com agent em vez de olho

Na linha da tabela

Clique com o botão direito
Importar
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

PropTipoPadrão
actionsRef0.4.0

Uma ref para as ações imperativas.

RefObject<MenuRootActions | null>sem padrão
closeParentOnEsc0.4.0booleansem padrão
defaultOpen0.4.0

Se o menu começa aberto.

booleanfalse
disabled0.4.0

Se a peça deve ignorar a interação do usuário.

booleanfalse
highlightItemOnHover0.4.0

Se passar o ponteiro sobre os itens os destaca.

booleantrue
loopFocus0.4.0

Se o foco do teclado volta ao primeiro item ao chegar no fim da lista pelas setas.

booleantrue
onItemHighlighted

Chamado quando um item ganha ou perde o destaque.

((highlightedItem: HTMLElement | undefined, eventDetails: MenuRootHighlightEventDetails) => void)sem padrão
onOpenChange0.4.0

Chamado quando o menu abre ou fecha.

((open: boolean, eventDetails: ContextMenuRootChangeEventDetails) => void)sem padrão
onOpenChangeComplete0.4.0

Chamado depois que as animações terminam, quando o menu abre ou fecha.

((open: boolean) => void)sem padrão
open0.4.0

Se o menu está aberto agora.

booleansem padrão
orientation0.4.0

A orientação visual do menu.

MenuRootOrientation"vertical"

@rivocode/ui, 149 peças no catálogo. Esta página é gerada dos mesmos arquivos que alimentam o design system, então ela não envelhece sozinha.

Feito por RivoCode.