滑动条组件用于在一个区间内选择一个值, 用户通过拖动滑块来选择需要的值。
ID
: 组件ID,可用于在脚本或模板中引用该组件。方向
: 设置滑动条的方向,支持水平和垂直两种。显示取值
: 设置是否显示滑动条的取值。最大值
: 设置滑动条的最大值, 默认值为100。最小值
: 设置滑动条的最小值, 默认值为0。步长
: 设置滑动条的步长, 默认值为1。默认值
: 设置滑动条的默认值。标记
: 设置滑动条的标记值, 标记用于在滑动条上显示特定的取值。脚本
: 定义组件事件处理函数或其他功能函数。坐标X
: 设置滑动条坐标X取值。坐标Y
: 设置滑动条坐标Y取值。坐标Z
: 设置滑动条坐标Z取值。滑动
: 当滑动条滑动时触发的事件。滑动结束
: 当滑动条滑动结束时触发的事件。$this
$this
为当前组件实例,您可以通过 $this
对象调用组件的各种方法。
▲ 组件初始化
void init()
当组件存在init
方法时,组件初始化时会调用该方法。
脚本示例:
export function init() {
// your code here
}
▲ 设置/获取当前值
string value(string value)
请求参数:
value
: <字符串> 可选项, 设置当前开关值。返回值:<字符串> 当前开关值
模板示例:
{{$widget("input").value()}}
脚本示例:
// 设置输入框值
$this.value("hello");
$panel.widget("input").value(123);
// 获取输入框值
let value = $this.value();
let value = $panel.widget("input").value();
$panel
$panel
对象为当前面板实例,您可以通过 $panel
对象调用面板的各种方法。
▲ 设置/获取变量
string variable(string name, string value=undefined)
请求参数:
name
: <字符串> 必选项, 变量名称。value
: <字符串> 可选项, 设置变量值。返回值:<字符串> 变量值
脚本示例:
// 设置变量值
$panel.variable("name", "value");
// 获取变量值
let value = $panel.variable("name");
▲ 获取组件实例
object widget(string id)
请求参数:
id
: <字符串> 必选项, 组件ID。返回值:<对象> 组件实例
脚本示例:
// 获取组件实例
let widget = $panel.widget("switch");
// 获取开关值
let value = widget.value();
$
脚本上下文 $
是一个全局对象, 包含常用的全局函数和对象。
▲ 延时给定的毫秒数
async msleep(Integer ms)
例如 :
await $.msleep(1000);
▲ 显示确认对话框
async confirm(String message)
参数:
message
: 消息内容返回值: true
,否则返回 false
。
例如 :
let confirmed = await $.confirm("Are you sure?");
if ( confirmed ) {
$.alert("yes");
} else {
$.alert("no");
}
▲ 显示消息对话框
async alert(String message, String type=undefined)
参数:
message
: 消息内容type
: 消息类型,可选值为 error
、warning
, alert
。默认为 alert
。例如 :
$.alert("hello world");
// 显示错误信息
$.alert("hello world", "error");
// 显示警告信息
$.alert("hello world", "warning");
▲ 显示Toast消息
async toast(String message, String type=undefined)
参数:
message
: 消息内容type
: 消息类型,可选值为 success
, error
、warning
, info
。默认为 info
。例如 :
$.toast("hello world");
// 显示错误信息
$.toast("hello world", "error");
// 显示警告信息
$.toast("hello world", "warning");
▲ 显示通知消息
async notify(String title, String message, String type=undefined)
参数:
title
: 消息标题message
: 消息内容type
: 消息类型,可选值为 success
, error
、warning
, info
。默认为 info
。例如 :
$.notify("hello", "hello world");
// 显示错误信息
$.notify("hello", "hello world", "error");
// 显示警告信息
$.notify("hello", "hello world", "warning");
▲ 生成随机数
Integer random(Integer min, Integer max)
参数:
min
: 最小值max
: 最大值返回值:
例如 :
let value = $.random(1, 100);
▲ 生成随机字符串
String randomString(Integer length)
参数:
length
: 字符串长度返回值:
例如 :
let value = $.randomString(10);
▲ 执行指令
async execute(String name, Any params)
例如 :
let response = await $.execute(
"文件夹/指令名称", // 指令路径
{"name": "sige"} // 指令参数
);
// 等待1秒,用于等待指令执行完成
await $.msleep(1000);
// 读取指令执行结果
let text = response.readAs('text');
// 结束指令执行
response.cancel();
▲ 调用指令
async call(String name, Any params)
调用和执行指令的区别是, 调用模式下会在接收到响应内容后立即返回, 而执行模式下会持续接收响应内容。
例如 :
let response = await $.call(
"文件夹/指令名称", // 指令路径
{"name": "sige"} // 指令参数
);
▲ 获取环境变量
String env(String name, defaultValue=nul)
根据给定的环境变量名称获取环境变量的值, 当环境变量不存在时返回默认值。
例如 :
let value = $.env("name");
// 获取环境变量,如果不存在则返回默认值
let value = $.env("name", "default");