#跟着若城学鸿蒙# UI组件篇- 粘贴控件（PasteButton）及其属性

ArkUI中的粘贴控件（PasteButton）是一种特殊的安全控件，用于简化权限授权流程，提高用户体验并保障隐私安全。粘贴控件允许用户通过点击按钮临时获取读取剪贴板的权限，而无需通过权限弹框进行授权确认。

Huang兄

599人浏览 · 2025-05-21 21:59:57

Huang兄 · 2025-05-21 21:59:57 发布

ArkUI中的粘贴控件（PasteButton）是一种特殊的安全控件，用于简化权限授权流程，提高用户体验并保障隐私安全。粘贴控件允许用户通过点击按钮临时获取读取剪贴板的权限，而无需通过权限弹框进行授权确认。以下是粘贴控件的详细介绍：

粘贴控件的属性

iconSize
- 描述：设置粘贴控件上图标的尺寸。
- 类型：Dimension
- 默认值：16vp
layoutDirection
- 描述：设置粘贴控件上图标和文字分布的方向。
- 类型：SecurityComponentLayoutDirection
- 默认值：SecurityComponentLayoutDirection.HORIZONTAL
position
- 描述：设置绝对定位，设置粘贴控件的左上角相对于父容器左上角的偏移位置。
- 类型：Position
- 默认值：{x: 0, y: 0}
markAnchor
- 描述：设置粘贴控件在位置定位时的锚点，以控件左上角作为基准点进行偏移。
- 类型：Position
- 默认值：{x: 0, y: 0}
offset
- 描述：设置粘贴控件相对于自身布局位置的坐标偏移。
- 类型：Position | Edges | LocalizedEdges
- 默认值：{x: 0, y: 0}
fontSize
- 描述：设置粘贴控件上文字的尺寸。
- 类型：Dimension
- 默认值：16fp
fontStyle
- 描述：设置粘贴控件上文字的样式。
- 类型：FontStyle
- 默认值：FontStyle.Normal
fontWeight
- 描述：设置粘贴控件上文字粗细。
- 类型：number | FontWeight | string
- 默认值：FontWeight.Medium
fontFamily
- 描述：设置粘贴控件上文字的字体。
- 类型：string | Resource
- 默认值：'HarmonyOS Sans'
fontColor
- 描述：设置粘贴控件上文字的颜色。
- 类型：ResourceColor
- 默认值：$r(‘sys.color.font_on_primary’)
iconColor
- 描述：设置粘贴控件上图标的颜色。
- 类型：ResourceColor
- 默认值：$r(‘sys.color.icon_on_primary’)
backgroundColor
- 描述：设置粘贴控件的背景颜色。
- 类型：ResourceColor
- 默认值：$r(‘sys.color.icon_emphasize’)
borderStyle
- 描述：设置粘贴控件的边框的样式。
- 类型：BorderStyle
- 默认值：无边框样式
borderWidth
- 描述：设置粘贴控件的边框的宽度。
- 类型：Dimension
- 默认值：无边框宽度
borderColor
- 描述：设置粘贴控件的边框的颜色。
- 类型：ResourceColor
- 默认值：无边框颜色
borderRadius
- 描述：设置粘贴控件的边框圆角半径。
- 类型：Dimension
- 默认值：无边框圆角半径
padding
- 描述：设置粘贴控件的内边距。
- 类型：Padding | Dimension
- 默认值：上下8vp，左右16vp
align
- 描述：设置粘贴控件图标文本的对齐方式。
- 类型：Alignment
- 默认值：Alignment.Center
textIconSpace
- 描述：设置粘贴控件中图标和文字的间距。
- 类型：Dimension
- 默认值：4vp
width
- 描述：设置粘贴控件自身的宽度。
- 类型：Length
- 默认值：根据元素内容自适配宽度
height
- 描述：设置粘贴控件自身的高度。
- 类型：Length
- 默认值：根据元素内容自适配高度
size
- 描述：设置粘贴控件的高宽尺寸。
- 类型：SizeOptions
- 默认值：根据元素内容自适配高宽尺寸
constraintSize
- 描述：设置粘贴控件的约束尺寸。
- 类型：ConstraintSizeOptions
- 默认值：{minWidth: 0, maxWidth: Infinity, minHeight: 0, maxHeight: Infinity}
alignRules
- 描述：指定设置在相对容器中子组件的对齐规则。
- 类型：AlignRuleOption
- 默认值：无
id
- 描述：组件的唯一标识。
- 类型：string
- 默认值：""

使用示例

以下是一个使用粘贴控件的示例代码：



@Entry
@Component
struct PasteButtonExample {
  pasteButtonOptions: PasteButtonOptions =
    { icon: PasteIconStyle.LINES, text: PasteDescription.PASTE, buttonType: ButtonType.Capsule };

  build() {
    Row() {
      Column() {
        PasteButton(this.pasteButtonOptions).onClick((event: ClickEvent, result: PasteButtonOnClickResult)=> {
          if (result ==
          PasteButtonOnClickResult.SUCCESS) {
            // 处理粘贴成功逻辑 
          } else {
            // 处理粘贴失败逻辑 
          }
        });
      }.width('100%')
    }.height('100%');
  }
}

在这个示例中，我们创建了一个粘贴控件，并设置了图标的样式、文字描述和按钮类型。当用户点击粘贴控件时，会触发onClick回调，开发者可以在回调中处理粘贴成功或失败的逻辑。

----

以上