涂鸦文本输入客户端

向 TextInputClient 接口添加了 showToolbar、insertTextPlaceholder 和 removeTextPlaceholder 这三个方法，以便 iOS 14 涂鸦功能能够插入和移除文本占位符以及显示工具栏。

从 iOS 14 开始，iPad 在使用 Apple Pencil 时支持涂鸦功能。此功能允许用户使用 Apple Pencil 与文本字段交互，以添加、删除、选择和修改文本。

在原生文本小部件中，当用户在运行 iOS 14 或更高版本的 iPad 上使用 Apple Pencil 选择文本时，文本工具栏会显示。为复制此行为，平台会发送一个名为 TextInputClient.showToolbar 的 textInput 通道消息。这会通知 Dart 代码应显示工具栏。

当用户按住 Apple Pencil 时，文本中会显示一个可视的间隙，以便用户有额外的书写空间。为复制此行为，平台会发送名为 TextInputClient.insertTextPlaceholder 和 TextInputClient.removeTextPlaceholder 的 textInput 通道消息。多行文本输入应具有提供垂直空间的占位符，而单行输入应提供水平空间。

如果您之前已实现 TextEditingClient，则必须覆盖 showToolbar、insertTextPlaceholder 和 removeTextPlaceholder 以支持这些涂鸦功能或提供空实现。

要迁移，请实现 showToolbar、insertTextPlaceholder 和 removeTextPlaceholder。

迁移前的代码

class MyCustomTextInputClient implements TextInputClient {
  ...
}

迁移后的代码

class MyCustomTextInputClient implements TextInputClient {
  ...
  @override
  void showToolbar() {
    ...
  }
  
  @override
  void insertTextPlaceholder(Size size) {
    ...
  }
  
  @override
  void removeTextPlaceholder() {
    ...
  }
}

发布版本：2.9.0-1.0.pre
稳定版本: 2.10

API 文档

• TextInputClient

相关问题

• 问题 61278

相关 PR

• 24224: 支持涂鸦手写 (引擎)
• 75472: 支持涂鸦手写
• 97437: 重新发布支持涂鸦手写