Tratando gestos na web com Flutter
Explore como eventos de ponteiro, detecção de gestos e comportamento de rolagem diferem ao criar apps Flutter para web.
O Flutter lançou suporte para web, que permite criar sites dinâmicos. Com o Flutter para web, macOS, Linux e Windows (até mesmo em dispositivos móveis conectados a mouse, teclado ou outros periféricos), você agora tem acesso a comportamentos específicos de plataforma, incluindo suporte a foco, entrada pelo teclado, cursores de mouse personalizados e entrada por hover. Mas como usar esses comportamentos de plataforma no Flutter?
Este artigo explica como usar o widget FocusableActionDetector, que trata entrada pelo teclado, entrada de foco, entrada por hover e cursores de mouse personalizados.
Como usar o widget Focusable Action Detector
O widget Focusable Action Detector permite que você trate várias ações específicas da web, incluindo:
Entrada pelo teclado
Entrada de foco
Entrada por hover
Cursores de mouse personalizados
Veja o FocusableActionDetector em ação no exemplo DartPad #1.
Nota: este artigo usa dois exemplos do DartPad, embora haja vários links para cada um. DartPad #1 mostra o exemplo
FocusableActionDetector, e DartPad #2 demonstra o suporte a hover e foco paraFocusableActionDetector.
Entrada pelo teclado
O Flutter permite definir ações personalizadas para tratar a entrada pelo teclado. Digamos que você queira ter um menu oculto ou que seu app precise tratar muitas entradas personalizadas de teclado. Isso é fácil de conseguir com o widget FocusableActionDetector.
Primeiro, adicione o seguinte import:
import 'package:flutter/services.dart';
Em seguida, na classe onde o FocusableActionDetector é chamado, inicialize duas variáveis privadas. Essas variáveis mapeiam a entrada do teclado para a ação desejada:
Map<LogicalKeySet, Intent> _shortcutMap;
Map<Type, Action<Intent>> _actionMap;
Defina um widget FocusableActionDetector. Observe que a entrada personalizada do teclado só é ativada quando o widget filho está em foco:
FocusableActionDetector(
actions: _actionMap,
shortcuts: _shortcutMap,
child: …,
);
Esta classe mapeia os enums e o tipo de entrada do teclado para a classe Intent. A configuração a seguir é necessária porque os parâmetros actions e shortcuts exigem uma classe que estenda
Intent:
class _ShowSecretMessageIntent extends Intent {
const _ShowSecretMessageIntent({@required this.type});
const _ShowSecretMessageIntent.P() : type = _SecretMessageType.P;
const _ShowSecretMessageIntent.L() : type = _SecretMessageType.L;
const _ShowSecretMessageIntent.A() : type = _SecretMessageType.A;
const _ShowSecretMessageIntent.T() : type = _SecretMessageType.T;
const _ShowSecretMessageIntent.F() : type = _SecretMessageType.F;
const _ShowSecretMessageIntent.O() : type = _SecretMessageType.O;
const _ShowSecretMessageIntent.R() : type = _SecretMessageType.R;
const _ShowSecretMessageIntent.M() : type = _SecretMessageType.M;
final _SecretMessageType type;
}
enum _SecretMessageType {
P,
L,
A,
T,
F,
O,
R,
M,
}
Dentro do método initState, inicialize o mapeamento definido anteriormente:
void initState() {
_shortcutMap = <LogicalKeySet, Intent>{
LogicalKeySet(LogicalKeyboardKey.keyP): const _ShowSecretMessageIntent.P(),
LogicalKeySet(LogicalKeyboardKey.keyL): const _ShowSecretMessageIntent.L(),
LogicalKeySet(LogicalKeyboardKey.keyA): const _ShowSecretMessageIntent.A(),
LogicalKeySet(LogicalKeyboardKey.keyT): const _ShowSecretMessageIntent.T(),
LogicalKeySet(LogicalKeyboardKey.keyF): const _ShowSecretMessageIntent.F(),
LogicalKeySet(LogicalKeyboardKey.keyO): const _ShowSecretMessageIntent.O(),
LogicalKeySet(LogicalKeyboardKey.keyR): const _ShowSecretMessageIntent.R(),
LogicalKeySet(LogicalKeyboardKey.keyM): const _ShowSecretMessageIntent.M(),
};
_actionMap = <Type, Action<Intent>>{
_ShowSecretMessageIntent: CallbackAction<_ShowSecretMessageIntent>(
onInvoke: _actionHandler,
),
};
}
O manipulador de ação vincula a entrada do teclado a uma função específica do app. Sempre que um caractere é pressionado, um contêiner expandido é adicionado à parte principal do app. Mas no seu app, você pode usá-lo para fins mais criativos:
void _actionHandler(_ShowSecretMessageIntent intent) {
switch (intent.type) {
case _SecretMessageType.P:
setState(() {
children.add(
Expanded(
child: Container(
color: Colors.orange,
child: Text('Press L'),
),
),
);
});
break;
// …
}
}
Entrada de foco
O widget FocusableActionDetector permite executar chamadas de ação sempre que o widget especificado estiver em foco.
A árvore de foco permite navegar pelo seu app usando a tecla Tab. Isso permite que pessoas com deficiência visual naveguem pelo seu site.
O widget filho FocusableActionDetector é selecionado como o foco inicial quando nenhum outro nó em seu escopo está focado no momento. É importante definir o parâmetro autofocus como true se você quiser que sua entrada personalizada de teclado funcione independentemente de o widget filho ter foco ou não. Isso porque, por padrão, este widget FocusableActionDetector não terá foco, portanto você não poderá usar entradas personalizadas de teclado:
FocusableActionDetector(
autofocus: true,
child: …,
),
Digamos que você queira que seu widget filho tenha uma cor diferente quando estiver em foco, para identificar que ele está em foco no momento. Se precisar definir ações personalizadas sempre que o widget tiver foco, use a propriedade onShowFocusHighlight.
O exemplo DartPad #2 mostra como usar a propriedade onShowFocusHighlight.
O foco é um tópico avançado. Saiba mais sobre foco lendo a documentação da API da Focus
classe
Entrada por hover
O widget FocusableActionDetector permite tratar a entrada do hover (quando o cursor passa sobre algo). Assim, sempre que o cursor passa sobre determinado widget, ações personalizadas podem acontecer. Semelhante à propriedade
onShowFocusHighlight, a propriedade onShowHoverHighlight permite criar ações personalizadas sempre que o cursor do mouse passa sobre um widget.
Confira o exemplo DartPad #2, que demonstra como implementar ações personalizadas de hover e foco.
No exemplo DartPad #2, sempre que o mouse passa sobre o widget, a cor dele muda. Se você navega pelo app usando a tecla Tab, vai notar que o widget em foco recebe um tom diferente do widget que está sob o cursor.
Isso significa que você pode ter ações personalizadas diferentes quando o widget está em foco ou quando um cursor do mouse passa sobre ele. Você percebe isso se passar o mouse e focar no mesmo widget: ele aplica dois tons ao mesmo tempo. Para mais informações, veja a documentação da API da
FocusableActionDetector
classe.
Cursores de mouse personalizados
O widget FocusableActionDetector permite implementar cursores de mouse personalizados. Por exemplo, se você quer que os usuários saibam que um widget pode ser arrastado, mudar o cursor do mouse é um bom indicador de que isso é possível. O
FocusableActionDetector tem um parâmetro mouseCursor.
mouseCursor: SystemMouseCursors.grabbing,
O exemplo DartPad #1 demonstra os diferentes tipos de cursores de mouse no Flutter. Clique em qualquer um dos ícones na barra do app para experimentar. Há nove cursores de mouse padrão do sistema:
SystemMouseCursors.basicSystemMouseCursors.textSystemMouseCursors.clickSystemMouseCursors.forbiddenSystemMouseCursors.grabSystemMouseCursors.grabbingSystemMouseCursors.horizontalDoubleArrow(não está no canal stable)SystemMouseCursors.verticalDoubleArrow(não está no canal stable)SystemMouseCursors.none
Considerações finais
No Flutter você tem acesso a APIs específicas da web. O widget FocusableActionDetector permite tratar funções específicas da web no Flutter. Para saber mais sobre o Flutter web, veja o post do blog
Tratando o erro 404: página não encontrada no Flutter.
Sobre o autor: Jose se formou na universidade recentemente e agora trabalha no Material, um design system que ajuda equipes a criar experiências digitais de alta qualidade. A equipe de Jose mantém a biblioteca material do Flutter. Para saber mais, visite as páginas de Jose no GitHub, LinkedIn, YouTube e Instagram.