Button 动作按钮
此组件在界面上显示一个按钮, 用于执行一个动作.
键 | 类型 | 描述 | 必选 | 默认值 | 最低版本需求 |
---|---|---|---|---|---|
action | 字符串 | 动作标识 | * | - | - |
args | 字典 | 传递给动作的参数 | * | - | - |
alignment | 字符串 | 对齐方式 | - | Left | 1.2-10 |
alignment | 描述 |
---|---|
Left | 左对齐 |
Center | 居中 |
Right | 右对齐 |
Natural | 自然对齐 |
Justified | 两边对齐 |
动作说明
动作执行完成后, 会将动作的返回值保存到该组件的配置对中, 因此需要正确设置该组件的 key
和 defaults
属性.
不同的 action
动作需要传递不同的参数字典 args
.
Reload:
刷新 XUI,重新加载所有运行中的 XUI 实例, 需要 XXT v1.2-10 及更高版本.
无参数, 无返回值
RunCommand:
调用 system
/posix_spawn
执行命令行, 需要 XXT v1.2-10 及更高版本.
键 | 类型 | 描述 | 必选 | 默认值 | 最低版本需求 |
---|---|---|---|---|---|
command | 字符串 | 欲执行的命令行字符串 | * | - | 1.2-10 |
返回值类型 | 描述 |
---|---|
整数 | 命令行执行的返回值 Exit Status |
LaunchScript:
运行服务脚本.
键 | 类型 | 描述 | 必选 | 默认值 | 最低版本需求 |
---|---|---|---|---|---|
path | 字符串 | 服务脚本路径 | * | - | - |
无返回值
OpenURL:
在第三方应用中打开URL.
键 | 类型 | 描述 | 必选 | 默认值 | 最低版本需求 |
---|---|---|---|---|---|
url | 字符串 | 欲打开的URL | * | - | - |
无返回值
ScanQRCode:
调起相机, 扫描二维码.
无参数
返回值类型 | 描述 |
---|---|
字符串 | 二维码扫描结果 |
SendMail:
在应用中, 发送邮件.
键 | 类型 | 描述 | 必选 | 默认值 | 最低版本需求 |
---|---|---|---|---|---|
subject | 字符串 | 邮件主题 | * | - | - |
toRecipients | 包含字符串的数组 | 收件邮箱地址数组 | * | - | - |
ccRecipients | 包含字符串的数组 | 抄送邮箱地址数组 | - | {} |
- |
bccRecipients | 包含字符串的数组 | 密送邮箱地址数组 | - | {} |
- |
attachments | 包含字符串的数组 | 携带附件的路径数组 | - | {} |
- |
无返回值
Null:
无动作, 一般用于重置一个特定的配置值, 并发出相应通知给脚本, 需要 XXT v1.2-10 及更高版本.
无参数, 无返回值
示例
{
cell = "Button";
action = "OpenURL:";
label = "联系 info@xxtouch.com";
args = {
url = "mailto://info@xxtouch.com";
}
};