SwitchCell 开关单元格

使用指南

在 index.json 中引入组件

"usingComponents": {
  "van-switch-cell": "path/to/vant-weapp/dist/switch-cell/index"
}

代码演示

基础用法

<van-switch-cell
  title="标题"
  checked="{{ checked }}"
  bind:change="onChange"
/>
Page({
  data: {
    checked: true
  },

  onChange(event) {
    // 需要手动对 checked 状态进行更新
    this.setData({ checked: event.detail });
  }
});

禁用状态

通过disabled属性可以将组件设置为禁用状态

<van-switch-cell
  disabled
  title="标题"
  checked="{{ checked }}"
  bind:change="onChange"
/>

加载状态

通过loading属性可以将组件设置为加载状态

<van-switch-cell
  loading
  title="标题"
  checked="{{ checked }}"
  bind:change="onChange"
/>

API

参数 说明 类型 默认值
name 在表单内提交时的标识符 String -
checked 开关状态 Boolean -
title 左侧标题 String ''
loading 是否为加载状态 Boolean false
disabled 是否为禁用状态 Boolean false
size 开关尺寸 String 26px

Event

事件名 说明 参数
bind:change 开关状态切换回调 event.detail: 是否选中开关