---

theme: cyanosis

在桌面端的开发中，键盘快捷键是非常常见而必要的，比如 Ctrl + F 搜索， Ctrl + C 复制等。Flutter 既然可以开发桌面端应用，那必然要提供自定义快捷键，触发事件的功能支持。这就是本节要介绍的 Shortcuts 组件体系，相关代码后续会放入 FlutterUnit 中，敬请关注 ~

---

1. Shortcuts 组件的简单使用

首先，来个简单的功能体验一下。还是那初始的计数器项目来开刀，之前是点击按钮数字增加，现在试一下通过快捷键触发更新的逻辑：

快捷键体系中，Shortcuts 组件维护快捷键(ShortcutActivator)和意图(Intent) 数据的映射，也就是说一个 Shortcuts 组件内部可以定义若干个快捷键。比如下面定义 Ctrl + Q 的快捷键，其对应的意图是 IncrementIntent。

dart Widget buildShortcuts({required Widget child}) { return Shortcuts( shortcuts: <ShortcutActivator, Intent>{ LogicalKeySet(LogicalKeyboardKey.control, LogicalKeyboardKey.keyQ): const IncrementIntent(), }, child: Actions( actions: <Type, Action<Intent>>{ IncrementIntent: CallbackAction<IncrementIntent>(onInvoke: _incrementCounter), }, child: Focus( autofocus: true, child: child, ), ), ); }

我们需要派生 Intent 来自定义需要的意图，作为事件响应的标识。通过 Actions 组件根据意图来响应快捷键，其中通过 actions 参数维护类型和 Action 回调事件，触发状态类中 _incrementCounter 方法即可。

另外，快捷键体系需要焦点的支持，所以需要 Focus 组件，只有焦点在激活状态，快捷键才可以响应，通过焦点可以控制快捷键是否响应。想要默认情况下响应，可以将 autofocus 置为 true 。

``` ---->[状态类中]---- void _incrementCounter(IncrementIntent intent) { setState(() { _counter++; }); }

class IncrementIntent extends Intent { const IncrementIntent(); } ```

在事件响应时，可以获取意图对象。所以可以在意图派生类中提供成员数据，以便在事件响应时进行访问。比如这里 IncrementIntent 可以有一个增加值的成员，这样在 _incrementCounter 可以获取到意图对象，处理每次自增多少的逻辑。

---

最后，使用 buildShortcuts 方法包裹在想要响应快捷键的组件上即可，当然你可以直接套上去，或者封装一个组件单独维护快捷键的处理。这属于代码结构的问题，可以自己斟酌。

---

2. 快捷键与焦点的关联

下面实现一些输入框通过 Ctrl + Enter 快捷键发送的功能，介绍一下快捷键和焦点的关联。现在的目的是只有当输入框获取焦点之后，才可以响应快捷键。对于输入框来说，它内部有 Focus 组件，并且可以提供 FocusNode 焦点对象来控制焦点：对于输入框来说，焦点激活就是可输入状态：

final FocusNode _inputNode = FocusNode();

TextField 组件可以设置 focusNode 参数设置焦点对象，

如下所示，提供 buildShortcutsSend 方法，使用 Ctrl + enter 触发 SendMessageIntent 意图。快捷键触发时，回调 _sendMessage 方法，其中取消焦点，清空文字。焦点取消之后，就无法响应快捷键了，当点击输入框时，焦点会再次激活，可以响应快捷键。

``` Widget buildShortcutsSend({required Widget child}) { return Shortcuts( shortcuts: { LogicalKeySet(LogicalKeyboardKey.control, LogicalKeyboardKey.enter): const SendMessageIntent(), }, child: Actions( actions: >{ SendMessageIntent: CallbackAction (onInvoke: _sendMessage), }, child: child, ), ); }

void sendMessage(SendMessageIntent intent) { print("====sendMessage:${ctrl.text}==================="); _inputNode.unfocus(); ctrl.clear(); }

class SendMessageIntent extends Intent { const SendMessageIntent(); } ```

到这里，键盘快捷键的使用就介绍得差不多了，希望可以对你在桌面端的开发有所帮助。关于 Focus 体系也是一个比较复杂的东西，以后有机会再详细介绍。那本文就到这了，谢谢观看 ~