脚本的配置功能怎么使用,假设我在脚本配置里面配置[
{
"name": "text_01",
"type": "text",
"label": "单行文本",
"validation": "required",
"help": "单行文本的帮助说明"
},
{
"name": "textarea_01",
"type": "textarea",
"label": "多行文本",
"validation": "required",
"help": "多行文本的帮助说明"
},
{
"name": "select_01",
"type": "select",
"label": "下拉选择",
"options": {
"a": "选项 A",
"b": "选项 B"
},
"validation": "required",
"help": "下拉选择的帮助说明"
},
{
"name": "radio_01",
"type": "radio",
"label": "单选",
"options": {
"a": "选项 A",
"b": "选项 B"
},
"help": "单选的帮助说明"
},
{
"name": "checkbox_01",
"type": "checkbox",
"label": "复选",
"help": "复选的帮助说明"
},
{
"name": "checkbox_02",
"type": "checkbox",
"label": "多个复选",
"options": {
"c": "选项 C",
"d": "选项 D"
},
"help": "多个复选的帮助说明"
},
{
"name": "range_01",
"type": "range",
"label": "范围",
"min": 1,
"max": 10,
"help": "范围的帮助说明",
"show-value": true
}
]我怎么在我的脚本里面获取到这些参数值呢?,语法是什么

L-PPMT · 22 小时前

回答

Hamibot AI
1
· 22 小时前

文档地址 https://docs.hamibot.com/

你可以在脚本中通过 hamibot.env 对象来获取在脚本配置中定义的参数值。

每个配置项的 name 字段对应一个键名,其输入或选择的值会作为该键的值。例如:

// 获取单行文本输入
var text01 = hamibot.env.text_01;
log('单行文本: ' + text01);

// 获取多行文本输入
var textarea01 = hamibot.env.textarea_01;
log('多行文本: ' + textarea01);

// 获取下拉选择的值(返回选中选项的 key)
var select01 = hamibot.env.select_01;
log('下拉选择: ' + select01); // 可能是 'a' 或 'b'

// 获取单选按钮的值
var radio01 = hamibot.env.radio_01;
log('单选: ' + radio01); // 可能是 'a' 或 'b'

// 获取复选框的值
// 注意:未勾选时为 undefined,勾选后为 true
var checkbox01 = hamibot.env.checkbox_01;
if (checkbox01) {
    log('复选框 checkbox_01 已勾选');
} else {
    log('复选框 checkbox_01 未勾选');
}

// 获取多个复选框的值(返回对象,包含被选中的选项)
var checkbox02 = hamibot.env.checkbox_02;
// checkbox02 是一个对象,例如 { c: true } 或 { c: true, d: true }
for (var key in checkbox02) {
    if (checkbox02[key]) {
        log('选中的复选框: ' + key);
    }
}

// 获取滑动条范围值
var range01 = hamibot.env.range_01;
log('滑动条值: ' + range01); // 返回 1 到 10 之间的数字

注意事项:

  • 所有配置值都通过 hamibot.env 访问。
  • 如果配置项设置了 validation: "required",系统会在运行前校验是否已填写。
  • 复选框(checkbox)类型的行为略有不同:
    • 单个复选框(没有 options)返回布尔值(true/undefined)。
    • 多个选项的复选框(有 options)返回一个对象,键为选项 key,值为是否选中(true/false),但只有选中的项会被包含在结果中(即值为 true 的才存在)。
  • 数值类型的配置(如 range)返回的是数字类型。

这样你就可以根据用户在配置界面输入的内容动态控制脚本行为。

ℹ️ 本回答由 AI 生成,内容仅供参考