switch

<switch> v0.6.1+

Updated time: 14/06/2017

<switch> 是 Weex 的内置组件，用来创建与 iOS 一致样式的按钮。例如，在 iPhone 中的设置应用中的飞行模式按钮就是一个 switch 按钮。

子组件

<switch> 组件不支持任何子组件。

特性

  • checked {boolean}：默认值为 false，表明按钮是否开启 is on or not.
  • disabled {boolean}：默认值为 false，表明是否激活按钮

样式

值得注意的是，在这个组件上，有些样式组件属性不能使用，它们是：

  • width
  • height
  • min-width
  • min-height
  • margin
  • padding
  • border

注意：

如果 <switch> 的容器没有设置为 align-items：flex-start，则 Android 中的开关将被拉伸。

  • 通用样式

    • flexbox 布局
    • position
    • opacity
    • background-color

查看 组件通用样式

事件

  • change：改变开关状态时触发该事件。

    事件中 event 对象属性：

    • value: 组件布尔值真或假。
    • timestamp: 事件的时间戳。

  • 通用事件

    支持所有通用事件：

    • click
    • longpress
    • appear
    • disappear

查看 通用事件

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
<template>
  <div>
    <div class="example">
      <text class="label">normal</text>
      <switch></switch>
    </div>
    <div class="example">
      <text class="label">checked</text>
      <switch checked="true"></switch>
    </div>
    <div class="example">
      <text class="label">disabled</text>
      <switch disabled="true" checked="true"></switch>
      <switch disabled="true"></switch>
    </div>
    <div class="example">
      <text class="label">onchange</text>
      <switch @change="onchange"></switch>
      <text class="info">{{checked}}</text>
    </div>
  </div>
</template>
<script>
  export default {
    data () {
      return {
        checked: false
      }
    },
    methods: {
      onchange (event) {
        console.log(`onchage, value: ${event.value}`)
        this.checked = event.value
      }
    }
  }
</script>
<style scoped>
  .example {
    flex-direction: row;
    justify-content: flex-start;
    margin-top: 60px;
  }
  .label {
    font-size: 40px;
    line-height: 60px;
    width: 350px;
    color: #666;
    text-align: right;
    margin-right: 20px;
  }
  .info {
    font-size: 30px;
    line-height: 60px;
    color: #BBB;
    margin-left: 10px;
  }
</style>

Try it