V1.0.0
WinDesign A2UI Vue

WSwitch 组件 ​

开关组件，基于 WinDesignNext Switch 封装，用于两种状态之间的切换，支持 modelValue 数据绑定和 action 事件响应。

基础用法 ​

API ​

属性类型说明
componentstring固定为 WSwitch
modelValueDataBindingValue开关状态，支持 path 双向绑定
activeValueboolean | string | number | DataBindingValue开启时的值，默认 true
inactiveValueboolean | string | number | DataBindingValue关闭时的值，默认 false
activeTextstring | DataBindingValue开启时显示文字
inactiveTextstring | DataBindingValue关闭时显示文字
disabledboolean是否禁用
loadingboolean是否加载中
sizestring尺寸：large / default / small / mini
inlinePromptboolean文字显示在开关内部
actionAction状态变化事件

path 支持说明 ​

属性path 支持说明
modelValue✅开关状态双向绑定
activeValue✅动态配置开启值
inactiveValue✅动态配置关闭值
activeText✅动态配置开启文字
inactiveText✅动态配置关闭文字

modelValue 数据绑定 ​

布尔值绑定：

json
{ "modelValue": { "path": "/enabled" } }

自定义开关值（如 Y/N）：

json
{
  "activeValue": "Y",
  "inactiveValue": "N",
  "modelValue": { "path": "/notifyFlag" }
}

action 定义 ​

json
{
  "action": {
    "event": {
      "name": "onEnabledChange",
      "type": "change",
      "context": [{ "key": "enabled", "value": { "path": "/enabled" } }]
    }
  }
}

数据同步机制 ​

  1. Agent 定义组件并设置 modelValue.path
  2. Agent 通过 updateDataModel 初始化开关状态
  3. 用户切换后，渲染器自动 setData 写回 dataModel
  4. 配置了 action 时触发 A2UI 事件

使用场景 ​

场景推荐配置
功能启用/停用默认 true/false + modelValue.path
是/否标志位activeValue: "Y", inactiveValue: "N"
带文字说明activeText + inactiveText
动态文案activeText/inactiveText 使用 path 绑定

注意事项 ​

  • 绑定值类型需与 activeValue/inactiveValue 一致
  • A2UI JSON 不支持 beforeChange 等函数属性
  • 默认 change 事件触发 dataModel 同步

Design by UED