当前位置: 首页 > article >正文

鸿蒙安全控件之粘贴控件简介

粘贴控件是一种特殊的系统安全控件,它允许应用在用户的授权下无提示地读取剪贴板数据。

在应用集成粘贴控件后,用户点击该控件,应用读取剪贴板数据时不会弹窗提示。可以用于任何应用需要读取剪贴板的场景,避免弹窗提示对用户造成干扰。

例如,用户在应用外(如短信)复制了验证码,要在应用内粘贴验证码。用户原来在进入应用后,还需要长按输入框、在弹出的选项中点击粘贴,才能完成输入。而使用粘贴控件,用户只需进入应用后直接点击粘贴按钮,即可一步到位。

粘贴控件效果如图所示。
img

约束与限制

  • 临时授权会持续到灭屏、应用切后台、应用退出情况发生。
  • 应用在授权期间没有调用次数限制。
  • 为了保障用户的隐私不被恶意应用获取,应用需确保安全控件是可见的且用户能够识别的。开发者需要合理的配置控件的尺寸、颜色等属性,避免视觉混淆的情况,如果发生因控件的样式不合法导致授权失败的情况,请检查设备错误日志。

开发步骤

以简化用户填写验证码为例,参考以下步骤,实现效果:点击控件获取临时授权,粘贴内容到文本框,效果图请见上文。

  1. 导入剪贴板依赖。
import { pasteboard } from '@kit.BasicServicesKit';
  1. 添加输入框和粘贴控件。

    粘贴控件是由图标、文本、背景组成的类似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()
          .padding({top: 12, bottom: 12, left: 24, right: 24})
          .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%')
  }
}
     }
      .width('100%')
    }
    .height('100%')
  }
}

http://www.kler.cn/a/406261.html

相关文章:

  • 分层架构 IM 系统之架构演进
  • 核间通信-Linux下RPMsg使用与源码框架分析
  • Java学习笔记--数组常见算法:数组翻转,冒泡排序,二分查找
  • C#(11) 运算符重载
  • 常用的消息中间件
  • 【python】将word文档内容转换为excel表格
  • 通威传媒:移动AI数字人OLED透明屏应用案例
  • FPGA 第十讲 避免latch的产生
  • 太速科技-232-基于FMC的2收2发TLK2711子卡
  • Go语言的并发与管道
  • 【头歌实训:利用kmp算法求子串在主串中不重叠出现的次数】
  • 使用 前端技术 创建 QR 码生成器 API1
  • HTML详解(1)
  • 『 Linux 』网络层 - IP协议(一)
  • wireshark网络安全流量分析基础
  • 量化交易系统开发-实时行情自动化交易-3.4.3.4.期货衍生数据
  • 沥川的算法学习笔记:基础算法(3)----高精度算法
  • C++学习 - 03(单例模式)
  • 蓝队技能-应急响应篇Rookit后门进程提取网络发现隐藏技术Linux杀毒OpenArk
  • MATLAB和C++及Python流式细胞术
  • display: none和visibility: hidden的区别
  • json数据四大加载方式
  • LeetCode:700. 二叉搜索树中的搜索
  • Lucene(2):Springboot整合全文检索引擎TermInSetQuery应用实例附源码
  • PVE的优化与温度监控(二)—无法识别移动硬盘S.M.A.R.T信息的思考并解决
  • CSS布局学习2