# Scribble 文字輸入用戶端

> 為 TextInputClient 介面新增方法，以允許 Scribble 插入或移除文字佔位符並顯示工具列。





:::important
這些重大變更文件在其發布的版本時是準確的。隨著時間推移，這裡描述的
因應措施可能會變得不準確。一般而言，我們不會在每個版本發布時同步更新這些重大變更文件。

[重大變更索引檔案](/release/breaking-changes)列出了每個版本所建立的文件。
:::


## 摘要

在 `TextInputClient` 介面中新增三個方法：`showToolbar`、`insertTextPlaceholder` 和
`removeTextPlaceholder`，以支援 iOS 14 的 Scribble 功能插入與移除文字佔位符，以及顯示工具列。

## 背景

自 iOS 14 起，iPad 支援使用 Apple Pencil 的 Scribble 功能。
此功能允許使用者利用 Apple Pencil 與文字欄位 (text field) 互動，
以新增、刪除、選取及修改文字。

## 變更說明

在原生文字元件 (Text Widgets) 中，當使用者在執行 iOS 14 或更高版本的 iPad 上
使用 Apple Pencil 選取文字時，會顯示文字工具列。
為了重現這個行為，平台會發送名為 `TextInputClient.showToolbar` 的 `textInput` channel 訊息。
這會通知 Dart 程式碼應顯示工具列。

當使用者長按 Apple Pencil 時，文字中會出現一個視覺上的間隙，
讓使用者有額外空間書寫。
為了重現這個行為，平台會發送名為 `TextInputClient.insertTextPlaceholder` 和
`TextInputClient.removeTextPlaceholder` 的 `textInput` channel 訊息。
多行文字輸入應提供可供垂直書寫的佔位符，
而單行輸入則應提供水平空間。

## 遷移指南

如果你先前有實作 `TextEditingClient`，你必須覆寫
`showToolbar`、`insertTextPlaceholder` 和 `removeTextPlaceholder`，
以支援這些 Scribble 功能或提供空的實作。

遷移時，請實作 `showToolbar`、`insertTextPlaceholder` 和
`removeTextPlaceholder`。

遷移前的程式碼：

```dart
class MyCustomTextInputClient implements TextInputClient {
  ...
}
```

遷移後的程式碼：

```dart
class MyCustomTextInputClient implements TextInputClient {
  ...
  @override
  void showToolbar() {
    ...
  }

  @override
  void insertTextPlaceholder(Size size) {
    ...
  }

  @override
  void removeTextPlaceholder() {
    ...
  }
}
```

## 時程

合併於版本：2.9.0-1.0.pre<br>
穩定版釋出：2.10

## 參考資料

API 文件：

* [`TextInputClient`](https://api.flutter.dev/flutter/services/TextInputClient-class.html)

相關議題：

* [Issue 61278](https://github.com/flutter/flutter/issues/61278)

相關 PR：

* [24224: Support Scribble Handwriting (engine)][]
* [75472: Support Scribble Handwriting][]
* [97437: Re-land Support Scribble Handwriting][]

[24224: Support Scribble Handwriting (engine)]: https://github.com/flutter/engine/pull/24224
[97437: Re-land Support Scribble Handwriting]: https://github.com/flutter/flutter/pull/97437
[75472: Support Scribble Handwriting]: https://github.com/flutter/flutter/pull/75472