控件：按钮<Button>

功能概述

按钮标签，在锁屏界面有一块显示区域，能够触发Trigger等一系列的操作和命令，可以通过不同的状态标签来展现对应状态下设置的图片或者文字等。

应用场景

1、设置好按钮热区，点击该区域，切换壁纸。

2、滑动热区，播放动画的下一帧。

3、点击热区，大雨下起或者雪花飘落。

4、点击热区，花儿绽放。

支持范围

起始规范版本：HarmonyOS 5.0

是否平台特性：否

表1 **支持根标签**
	锁屏（Lockscreen）	桌面（Wallpaper）	一镜到底（LongTake）	百变卡片（Widget）	充电动效（ChargingSkin）
是否支持	√	x	√	√	x

表2 **支持设备类型**
	直板机	折叠屏	平板
是否支持	√	√	√

XML规范

<Button name="" w="" h="" x="" y="" visibility="" />

参数说明

Button

参数	类型	选项	注释
name	字符串	选填	按钮的名称
visibility	字符串	选填	元素可见性支持表达式<=0 不可见 >0可见
Trigger	字符串	必填	用来定义按钮、Unlocker、Slider等动作引发相关的操作，可以控制某元素的属性。其规定了触发的动作(action)，并且触发了一系列命令(Command)的执行。

Trigger

参数

类型

选项

注释

action

字符串

必填

锁屏和桌面按钮动作： down (按下), up (抬起), double (双击)，resume（亮屏触发）,pause（熄屏触发），long（长按500ms），longClick（长按500ms后松手时触发，仅锁屏支持，起始规范版本：HarmonyOS 7.0），click（点击）;

百变卡片按钮动作：click（点击）

应用示例

示例一：未点击按钮时，按钮可见、text文本框显示"可见性：visibility为false，按钮不变"；单击之后，按钮不可见、text文本框显示"可见性：visibility为true，按钮消失"。