网页配置面板

SparkBridge 3.0 引入了原生网页配置面板，作为网页可视化配置编辑器

接入方法

推送配置

注：以下示例注册了一个名为example的插件

spark.web.createConfig('example')   // <-- 注意3.0.12之后，可以不传入自定义名称，加载器会寻找spark.json中的名称来创建
    .switch("enable", config.enable, "是否启用插件")
    .number("group_id", config.group_id, "群组ID")
    .register();

监听更改

spark.on("config.update.example",(K,newV)=>{
    // 默认事件名称为config.update.${pluginName}
    // K 修改的配置项
    // newV 配置项更新的值
})

API

spark.web.createConfig("example")
    .switch("switch", config.enable, "注册一个开关")
    .text("text", config.text, "注册一个文本框")
    .number("number", config.number, "注册一个数字框")
    .select("select", ["1", "2", "3"], 0, "注册一个选择框")
    .array("array", config.array, "注册一个数组框")
    .register();

select 参数说明

.select(key, options, val, desc)

• key：配置项名称
• options：选项数组（字符串）
• val：当前选中项（选项索引，数字：0 表示选中第一个选项）
• desc：描述文字

前端渲染组件按索引匹配选中项（formData[key] === index），因此 val 必须传数字索引而非选项字符串。保存时前端回传的也是索引数字，插件需要在 config.update.xxx 监听中将索引转换回实际语义值（示例：["false","master","slave"] 中 1 → "master"）。