内容

用户输入和可访问性

内容

自定义小部件的滚轮
标签遍历和焦点交互
- 控制遍历顺序
键盘加速键
自定义小部件的鼠标进入、退出和悬停
视觉密度

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

一些功能在 Material 小部件上默认启用。但是，如果您创建了自定义小部件，则可能需要直接实现它们。

一些包含良好设计应用程序的功能也有助于使用辅助技术的用户。例如，除了 **良好的应用程序设计** 之外，一些功能（如标签遍历和键盘快捷键）对于 **使用辅助设备的用户至关重要**。除了针对创建无障碍应用程序的标准建议外，本页面还介绍了有关创建既适应性强又无障碍的应用程序的信息。

像 ScrollView 或 ListView 这样的滚动小部件默认支持滚轮，并且由于几乎所有可滚动的自定义小部件都是使用其中之一构建的，因此它也适用于这些小部件。

如果您需要实现自定义滚动行为，可以使用 Listener 小部件，它允许您自定义 UI 对滚轮的反应方式。

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

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

标签交互有两个考虑因素：焦点如何从一个小部件移动到另一个小部件，称为遍历，以及一个小部件获得焦点时显示的视觉突出显示。

大多数内置组件（如按钮和文本字段）默认支持遍历和突出显示。如果您有自己的小部件想要包含在遍历中，可以使用 FocusableActionDetector 小部件来创建自己的控件。 FocusableActionDetector 小部件有助于在一个小部件中组合焦点、鼠标输入和快捷键。您可以创建一个检测器来定义操作和键绑定，并提供回调来处理焦点和悬停突出显示。

dartclass _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 键时被视为一个组的树部分。

例如，您可能需要在所有表单字段中进行制表符操作，然后再制表到提交按钮。

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

Flutter 有几种内置方法可以遍历小部件和组，默认情况下使用 ReadingOrderTraversalPolicy 类。此类通常效果很好，但可以使用另一个预定义的 TraversalPolicy 类或创建自定义策略来修改它。

除了制表符遍历之外，桌面和 Web 用户习惯于将各种键盘快捷键绑定到特定操作。无论是用于快速删除的 Delete 键还是用于新建文档的 Control+N，请务必考虑用户期望的不同加速键。键盘是一个强大的输入工具，因此请尝试尽可能地提高其效率。您的用户会对此表示感谢！

在 Flutter 中，可以使用几种方法来实现键盘加速键，具体取决于您的目标。

如果您有一个像 TextField 或 Button 这样的单个小部件，它已经有一个焦点节点，您可以将其包装在 KeyboardListener 或 Focus 小部件中，并监听键盘事件。

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 集合。例如，以下方法可以检查是否按下了任何提供的键。

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

将这两件事放在一起，您可以在按下 Shift+N 时触发操作。

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

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

  return false;
}

使用静态监听器时需要注意的一点是，您通常需要在用户在字段中输入内容或与之关联的小部件隐藏时禁用它。与 `Shortcuts` 或 `KeyboardListener` 不同，这是您需要管理的责任。当您为 `Delete` 绑定 Delete/Backspace 加速键，但随后有用户可能正在输入的子 `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 也有助于创建自定义的翻滚和悬停效果

dartreturn 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` 类使您可以轻松地调整整个应用程序中视图的密度，例如，通过在触摸设备上使按钮更大（因此更容易点击）。

当您更改 `MaterialApp` 的 `VisualDensity` 时，支持它的 `MaterialComponents` 会将其密度动画化以匹配。默认情况下，水平和垂直密度都设置为 0.0，但您可以将密度设置为所需的任何负值或正值。通过在不同密度之间切换，您可以轻松地调整 UI。

Adaptive scaffold

要设置自定义视觉密度，请将密度注入到您的MaterialApp主题中

dartdouble 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 指南。

自定义小部件的滚轮

标签遍历和焦点交互

控制遍历顺序

键盘加速键

自定义小部件的鼠标进入、退出和悬停

视觉密度