Orientação gerada a partir de informações públicas. Apenas para referência.
O pacote context_menus permite aos desenvolvedores exibir menus de contexto em aplicativos Flutter quando os usuários realizam cliques com o botão direito ou gestos de pressionar por tempo prolongado. Ele oferece uma maneira consistente e personalizável de apresentar opções de menu em múltiplas plataformas, incluindo dispositivos móveis, web e desktop. O pacote se integra perfeitamente ao sistema de widgets do Flutter e suporta interações baseadas em toque e ponteiro. Projetado para facilitar o uso, permite a implementação rápida de ações contextuais sem exigir lógica personalizada complexa. Ideal para aplicações que precisam de interações intuitivas com menus sensíveis ao contexto.
Casos de uso
Menus de contexto com clique direito no desktop
Menus de pressão longa em dispositivos móveis
Interações de UI consistentes com a plataforma
Painéis de ação personalizáveis
Fluxos de trabalho do usuário aprimorados
Elementos interativos do aplicativo
Principais recursos
Suporte multiplataforma
Clique direito e pressione por tempo prolongado para acionar
Itens de menu personalizáveis
Integração simples da API
Compatibilidade com design responsivo
Estilo de plataforma embutido
Indicado para
Desenvolvedores de aplicativos para desktop e móvel
aplicações com foco em UI
Interfaces de ação contextual
Aplicativos que exigem menus baseados em gestos
Desenvolvedores procurando soluções leves
Considerações
Requer manipulação manual de eventos de ponteiro
animações embutidas limitadas
Pode ser necessário estilização adicional para consistência
Não adequado para menus aninhados complexos
Depende da configuração correta de detecção de gestos
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
context_menus
A package to show context menus on right-click or long-press.
🔨 Installation
dependencies:context_menus:^1.0.2
⚙ Import
import'package:context_menus/context_menus.dart';
🕹️ Usage
To get started, wrap a ContextMenuOverlay around your top-most view or app:
In this case, you are responsible for closing the menu when your buttons are triggered, which you can do using an extension on BuildContext:
context.contextMenuOverlay.hide();
💡 Custom Menus
The easiest way to create a custom menu is to use the GenericContextMenu. Just pass it a list of ContextMenuButtonConfig instances:
/// Custom Context Menu for an ImageContextMenuRegion(
contextMenu: GenericContextMenu(
buttonConfigs: [
ContextMenuButtonConfig(
"View image in browser",
onPressed: () => launch(_testImageUrl),
),
ContextMenuButtonConfig(
"Copy image path",
onPressed: () => Clipboard.setData(ClipboardData(text: _testImageUrl)),
)
],
),
child: Image.network(_testImageUrl),
),
Another easy way to create custom menus is to use the ContextMenuStateMixin, and then call the cardBuilder and buttonBuilder methods to create your commands.
You can see this in action with the existing LinkContextMenu:
class_LinkContextMenuStateextendsState<LinkContextMenu> withContextMenuStateMixin{
@overrideWidgetbuild(BuildContext context) {
// cardBuilder is provided to us by the mixin, pass it a list of children to layoutreturn cardBuilder.call(
context,
[
// buttonBuilder is also provided by the mixin, use it to build each btn
buttonBuilder.call(
context,
// button builder needs a config, so it knows how to setup the btnContextMenuButtonConfig(
"Open link in new window",
icon: widget.useIcons ? Icon(Icons.link, size: 18) : null,
onPressed: () => handlePressed(context, _handleNewWindowPressed),
),
),
buttonBuilder.call(
context,
ContextMenuButtonConfig(
"Copy link address",
icon: widget.useIcons ? Icon(Icons.copy, size: 18) : null,
onPressed: () => handlePressed(context, _handleClipboardPressed),
),
)
],
);
}
In the above example, you could provide your own Card and Buttons directly, rather than using the builders, but the builders give you a couple of advantages:
You can style all menus using the button and card builders on the ContextMenuOverlay
All buttons will auto-close the context menu when triggered, saving you some boilerplate
Your custom menus will match the existing set of menus
🐞 Bugs/Requests
If you encounter any problems please open an issue. If you feel the library is missing a feature, please raise a ticket on Github and we'll look into it. Pull request are welcome.