塗鴉文字輸入用戶端

將三個方法 showToolbar、insertTextPlaceholder 和 removeTextPlaceholder 新增至 TextInputClient 介面，以允許 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：重新導入「支援隨手寫手寫功能」

除非另有說明，本網站上的文件反映了 Flutter 的最新穩定版本。頁面最後更新時間為 2024-04-04。 檢視原始碼 或 回報問題。