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 = "联系 [email protected]";
args = {
url = "mailto:[email protected]";
}
};
