仅仅调整应用程序的外观是不够的,你还必须支持各种用户输入。鼠标和键盘引入了触摸设备上没有的输入类型,例如滚轮、右键单击、悬停交互、Tab 键遍历和键盘快捷键。

其中一些功能在 Material 组件上默认工作。但是,如果你创建了自定义组件,你可能需要直接实现它们。

一些包含精心设计的应用程序的功能,也帮助使用辅助技术的人。例如,除了是良好的应用程序设计之外,一些功能(如 Tab 键遍历和键盘快捷键)对于使用辅助设备的用户至关重要。除了创建无障碍应用程序的标准建议之外,本页还介绍了创建既自适应又无障碍的应用程序的信息。

自定义组件的滚轮

#

ScrollViewListView 这样的滚动组件默认支持滚轮,并且由于几乎每个可滚动自定义组件都是使用其中之一构建的,因此它也适用于这些组件。

如果你需要实现自定义滚动行为,你可以使用 Listener 组件,它允许你自定义 UI 如何响应滚轮。

dart
return Listener(
  onPointerSignal: (event) {
    if (event is PointerScrollEvent) print(event.scrollDelta.dy);
  },
  child: ListView(),
);

Tab 键遍历和焦点交互

#

使用物理键盘的用户希望他们可以使用 Tab 键快速导航应用程序,而有运动或视觉障碍的用户通常完全依赖键盘导航。

Tab 键交互有两个注意事项:焦点如何在组件之间移动(称为遍历)以及组件获得焦点时显示的视觉高亮。

大多数内置组件(例如按钮和文本字段)默认支持遍历和高亮。如果你想将自己的组件包含在遍历中,可以使用 FocusableActionDetector 组件来创建自己的控件。FocusableActionDetector 组件有助于将焦点、鼠标输入和快捷方式组合在一个组件中。你可以创建一个定义动作和按键绑定,并提供处理焦点和悬停高亮回调的检测器。

dart
class _BasicActionDetectorState extends State<BasicActionDetector> {
  bool _hasFocus = false;
  @override
  Widget build(BuildContext context) {
    return FocusableActionDetector(
      onFocusChange: (value) => setState(() => _hasFocus = value),
      actions: <Type, Action<Intent>>{
        ActivateIntent: CallbackAction<Intent>(
          onInvoke: (intent) {
            print('Enter or Space was pressed!');
            return null;
          },
        ),
      },
      child: Stack(
        clipBehavior: Clip.none,
        children: [
          const FlutterLogo(size: 100),
          // Position focus in the negative margin for a cool effect
          if (_hasFocus)
            Positioned(
              left: -4,
              top: -4,
              bottom: -4,
              right: -4,
              child: _roundedBorder(),
            ),
        ],
      ),
    );
  }
}

控制遍历顺序

#

为了更好地控制用户通过 Tab 键遍历时组件的焦点顺序,你可以使用 FocusTraversalGroup 来定义在 Tab 键遍历时应被视为一组的树的各个部分。

例如,你可能希望在 Tab 键切换到提交按钮之前,先遍历表单中的所有字段。

dart
return Column(
  children: [
    FocusTraversalGroup(child: MyFormWithMultipleColumnsAndRows()),
    SubmitButton(),
  ],
);

Flutter 有几种内置的方法来遍历组件和组,默认为 ReadingOrderTraversalPolicy 类。这个类通常工作得很好,但可以使用另一个预定义的 TraversalPolicy 类或通过创建自定义策略来修改它。

键盘快捷键

#

除了 Tab 键遍历,桌面和 Web 用户习惯于将各种键盘快捷键绑定到特定操作。无论是用于快速删除的 Delete 键,还是用于新建文档的 Control+N,请务必考虑用户期望的不同快捷键。键盘是一个强大的输入工具,所以尽量从中榨取尽可能高的效率。你的用户会感谢你的!

根据你的目标,Flutter 中有几种方法可以实现键盘快捷键。

如果你有一个像 TextFieldButton 这样的单个组件,它已经有一个焦点节点,你可以用 KeyboardListenerFocus 组件包装它,并监听键盘事件。

dart
  @override
  Widget build(BuildContext context) {
    return Focus(
      onKeyEvent: (node, event) {
        if (event is KeyDownEvent) {
          print(event.logicalKey);
        }
        return KeyEventResult.ignored;
      },
      child: ConstrainedBox(
        constraints: const BoxConstraints(maxWidth: 400),
        child: const TextField(
          decoration: InputDecoration(border: OutlineInputBorder()),
        ),
      ),
    );
  }
}

要将一组键盘快捷键应用于树的大部分,请使用 Shortcuts 组件。

dart
// Define a class for each type of shortcut action you want
class CreateNewItemIntent extends Intent {
  const CreateNewItemIntent();
}

Widget build(BuildContext context) {
  return Shortcuts(
    // Bind intents to key combinations
    shortcuts: const <ShortcutActivator, Intent>{
      SingleActivator(LogicalKeyboardKey.keyN, control: true):
          CreateNewItemIntent(),
    },
    child: Actions(
      // Bind intents to an actual method in your code
      actions: <Type, Action<Intent>>{
        CreateNewItemIntent: CallbackAction<CreateNewItemIntent>(
          onInvoke: (intent) => _createNewItem(),
        ),
      },
      // Your sub-tree must be wrapped in a focusNode, so it can take focus.
      child: Focus(autofocus: true, child: Container()),
    ),
  );
}

Shortcuts 组件很有用,因为它只允许在此组件树或其子组件获得焦点并可见时触发快捷键。

最后一个选项是全局监听器。此监听器可用于始终开启的、应用程序范围的快捷方式,或用于只要可见就可以接受快捷方式的面板(无论其焦点状态如何)。使用 HardwareKeyboard 添加全局监听器很容易。

dart
@override
void initState() {
  super.initState();
  HardwareKeyboard.instance.addHandler(_handleKey);
}

@override
void dispose() {
  HardwareKeyboard.instance.removeHandler(_handleKey);
  super.dispose();
}

要使用全局监听器检查按键组合,可以使用 HardwareKeyboard.instance.logicalKeysPressed 集。例如,下面的方法可以检查是否按下了任何提供的键。

dart
static bool isKeyDown(Set<LogicalKeyboardKey> keys) {
  return keys
      .intersection(HardwareKeyboard.instance.logicalKeysPressed)
      .isNotEmpty;
}

将这两者结合起来,你可以在按下 Shift+N 时触发一个动作。

dart
bool _handleKey(KeyEvent event) {
  bool isShiftDown = isKeyDown({
    LogicalKeyboardKey.shiftLeft,
    LogicalKeyboardKey.shiftRight,
  });

  if (isShiftDown && event.logicalKey == LogicalKeyboardKey.keyN) {
    _createNewItem();
    return true;
  }

  return false;
}

使用静态监听器时需要注意一点,即当用户在字段中键入或与其关联的组件从视图中隐藏时,你通常需要禁用它。与 ShortcutsKeyboardListener 不同,这需要你自行管理。当你为 Delete 绑定一个删除/退格加速器,但用户可能正在子 TextFields 中键入时,这一点尤其重要。

自定义组件的鼠标进入、离开和悬停

#

在桌面端,通常会更改鼠标光标以指示鼠标悬停内容的功能。例如,当你悬停在按钮上时,通常会看到手形光标;当你悬停在文本上时,通常会看到 I 形光标。

Flutter 的 Material 按钮处理标准按钮和文本光标的基本焦点状态。(一个显著的例外是,如果你更改 Material 按钮的默认样式以将 overlayColor 设置为透明。)

为应用程序中的任何自定义按钮或手势检测器实现焦点状态。如果你更改了默认的 Material 按钮样式,请测试键盘焦点状态并在需要时实现你自己的焦点状态。

要在自定义组件中更改光标,请使用 MouseRegion

dart
// Show hand cursor
return MouseRegion(
  cursor: SystemMouseCursors.click,
  // Request focus when clicked
  child: GestureDetector(
    onTap: () {
      Focus.of(context).requestFocus();
      _submit();
    },
    child: Logo(showBorder: hasFocus),
  ),
);

MouseRegion 也适用于创建自定义的翻转和悬停效果。

dart
return MouseRegion(
  onEnter: (_) => setState(() => _isMouseOver = true),
  onExit: (_) => setState(() => _isMouseOver = false),
  onHover: (e) => print(e.localPosition),
  child: Container(
    height: 500,
    color: _isMouseOver ? Colors.blue : Colors.black,
  ),
);

有关在按钮获得焦点时更改按钮样式以描绘按钮轮廓的示例,请查看 Wonderous 应用程序的按钮代码。该应用程序修改了 FocusNode.hasFocus 属性,以检查按钮是否获得焦点,如果是,则添加轮廓。

视觉密度

#

你可能会考虑扩大组件的“点击区域”,例如,以适应触摸屏。

不同的输入设备提供不同级别的精度,这需要不同大小的点击区域。Flutter 的 VisualDensity 类可以轻松地调整整个应用程序中视图的密度,例如,在触摸设备上使按钮更大(因此更容易点击)。

当你更改 MaterialAppVisualDensity 时,支持它的 MaterialComponents 会将其密度调整为匹配。默认情况下,水平和垂直密度都设置为 0.0,但你可以将密度设置为任何负值或正值。通过在不同密度之间切换,你可以轻松调整 UI。

Adaptive scaffold

要设置自定义视觉密度,请将密度注入到 MaterialApp 主题中。

dart
double densityAmt = touchMode ? 0.0 : -1.0;
VisualDensity density = VisualDensity(
  horizontal: densityAmt,
  vertical: densityAmt,
);
return MaterialApp(
  theme: ThemeData(visualDensity: density),
  home: MainAppScaffold(),
  debugShowCheckedModeBanner: false,
);

要在你自己的视图中使用 VisualDensity,你可以查找它。

dart
VisualDensity density = Theme.of(context).visualDensity;

容器不仅能自动响应密度的变化,而且在密度变化时也会进行动画处理。这使得你的自定义组件与内置组件一起,在整个应用程序中实现平滑的过渡效果。

如所示,VisualDensity 是无单位的,因此它对不同的视图可能意味着不同的东西。在以下示例中,1 个密度单位等于 6 像素,但这完全由你决定。它是无单位的事实使其非常通用,并且应该适用于大多数情况。

值得注意的是,Material 通常为每个视觉密度单位使用大约 4 个逻辑像素的值。有关支持组件的更多信息,请参阅 VisualDensity API。有关密度原理的更多信息,请参阅 Material Design 指南