使用粘貼控件

粘貼控件是一種特殊的系統安全控件，它允許應用在用戶的授權下無提示地讀取剪貼板數據。

在應用集成粘貼控件后，用戶點擊該控件，應用讀取剪貼板數據時不會彈窗提示。可以用于任何應用需要讀取剪貼板的場景，避免彈窗提示對用戶造成干擾。

例如，用戶在應用外（如短信）復制了驗證碼，要在應用內粘貼驗證碼。用戶原來在進入應用后，還需要長按輸入框、在彈出的選項中點擊粘貼，才能完成輸入。而使用粘貼控件，用戶只需進入應用后直接點擊粘貼按鈕，即可一步到位。

粘貼控件效果如圖所示。

約束與限制

• 剪貼板讀取的臨時授權將持續到新的數據被寫入剪貼板為止（例如用戶復制了新的數據）。
• 臨時授權會持續到滅屏、應用切后臺、應用退出情況發生。
• 應用在授權期間沒有調用次數限制。
• 為了保障用戶的隱私不被惡意應用獲取，應用需確保安全控件是可見的且用戶能夠識別的。開發者需要合理的配置控件的尺寸、顏色等屬性，避免視覺混淆的情況，如果發生因控件的樣式不合法導致授權失敗的情況，請檢查設備錯誤日志。
• 開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

開發步驟

以簡化用戶填寫驗證碼為例，參考以下步驟，實現效果：點擊控件獲取臨時授權，粘貼內容到文本框，效果圖請見上文。

1. 導入剪貼板依賴。

   import { pasteboard } from '@kit.BasicServicesKit';
   

2. 添加輸入框和粘貼控件。
   粘貼控件是由圖標、文本、背景組成的類似Button的按鈕，其中圖標、文本兩者至少有其一，背景可選。圖標和文本不支持自定義，僅支持在已有的選項中選擇。
   應用申明安全控件的接口時，分為傳參和不傳參兩種，不傳參默認創建圖標+文字+背景的按鈕，傳參根據傳入的參數創建，不包含沒有配置的元素。
   當前示例使用默認參數。具體請參見[PasteButton控件]。此外，所有安全控件都繼承[安全控件通用屬性])，可用于定制樣式。

import { pasteboard, BusinessError } from '@kit.BasicServicesKit';

@Entry
@Component
struct Index {
  @State message: string = '';

  build() {
    Row() {
      Column({ space: 10 }) {
        TextInput({ placeholder: '請輸入驗證碼', text: this.message })
        PasteButton().onClick((event: ClickEvent, result: PasteButtonOnClickResult) = > {
          if (PasteButtonOnClickResult.SUCCESS === result) {
            pasteboard.getSystemPasteboard().getData((err: BusinessError, pasteData: pasteboard.PasteData) = > {
              if (err) {
                console.error(`Failed to get paste data. Code is ${err.code}, message is ${err.message}`);
                return;
              }
              // 剪貼板內容為 '123456'
              this.message = pasteData.getPrimaryText();
            });
          }
        })
      }
      .width('100%')
    }
    .height('100%')
  }
}

審核編輯 黃宇