表单

switch

布尔开关控件。

稳定 微信兼容子集

使用示例

<switch name="enabled" checked="{{enabled}}" bindchange="onSwitch" />

属性说明

属性类型默认值必填说明
idstring节点标识,可用于 label.for 或测试定位。
classstring附加样式类名。
stylestring受限内联样式。
hiddenbooleanfalse是否隐藏当前节点。
data-*string事件触发时进入 event.dataset。
namestring表单字段名。
checkedbooleanfalse是否默认选中。
disabledbooleanfalse是否禁用。
colorstring控件颜色。

事件说明

事件event.detail说明
bindchange{ value, checked }组件状态变化时触发。

Manifest 声明

能力组件必须声明权限和 API。没有宿主 provider 时,运行时会展示稳定降级态或返回结构化错误。

{
  "permissions": [],
  "apisUsed": []
}

平台支持

平台支持情况
Web支持
Android SDKWebView 运行时支持
iOS SDKWebView 运行时支持
Flutter SDKWebView 运行时支持

渲染协议

字段
HTML 标签input
样式类mini-switch
是否空元素
必填属性-
必需 API-