• Switch 开关
    • 概述
    • 代码示例
    • API
      • Switch props
      • Switch events
      • Switch slot

    Switch 开关

    概述

    在两种状态间切换时用到的开关选择器。

    注意:没有使用 iview-loader 时,必须使用 i-switch 标签。

    代码示例

    Switch 开关 - 图1

    基本

    基本用法,状态切换时会触发事件。

    1. <template>
    2. <Switch v-model="switch1" @on-change="change" />
    3. </template>
    4. <script>
    5. export default {
    6. data () {
    7. return {
    8. switch1: false
    9. }
    10. },
    11. methods: {
    12. change (status) {
    13. this.$Message.info('开关状态:' + status);
    14. }
    15. }
    16. }
    17. </script>

    Switch 开关 - 图2

    尺寸

    设置sizelargesmall 使用大号和小号的开关。

    1. <template>
    2. <Switch size="large" />
    3. <Switch />
    4. <Switch size="small" />
    5. </template>
    6. <script>
    7. export default {
    8. }
    9. </script>

    Switch 开关 - 图3

    文字和图标

    自定义内容,建议如果使用2个汉字,将开关尺寸设置为 large。

    1. <template>
    2. <Switch>
    3. <span slot="open"></span>
    4. <span slot="close"></span>
    5. </Switch>
    6. <Switch>
    7. <Icon type="md-checkmark" slot="open"></Icon>
    8. <Icon type="md-close" slot="close"></Icon>
    9. </Switch>
    10. <br><br>
    11. <Switch size="large">
    12. <span slot="open">开启</span>
    13. <span slot="close">关闭</span>
    14. </Switch>
    15. <Switch size="large">
    16. <span slot="open">ON</span>
    17. <span slot="close">OFF</span>
    18. </Switch>
    19. </template>
    20. <script>
    21. export default {
    22. }
    23. </script>

    Switch 开关 - 图4

    不可用

    禁用开关。

    1. <template>
    2. <Switch :disabled="disabled" />
    3. <Button type="primary" @click="disabled = !disabled">Toggle Disabled</Button>
    4. </template>
    5. <script>
    6. export default {
    7. data () {
    8. return {
    9. disabled: true
    10. }
    11. },
    12. }
    13. </script>

    Switch 开关 - 图5

    加载中

    标识开关操作仍在执行中。

    1. <template>
    2. <Switch loading :value="true" />
    3. <Switch loading :value="false" size="small" />
    4. </template>
    5. <script>
    6. export default {
    7. }
    8. </script>

    API

    Switch props

    属性说明类型默认值
    value指定当前是否选中,可以使用 v-model 双向绑定数据Booleanfalse
    size开关的尺寸,可选值为largesmalldefault或者不写。建议开关如果使用了2个汉字的文字,使用 large。String-
    disabled禁用开关Booleanfalse
    true-value选中时的值,当使用类似 1 和 0 来判断是否选中时会很有用String, Number, Booleantrue
    false-value没有选中时的值,当使用类似 1 和 0 来判断是否选中时会很有用String, Number, Booleanfalse
    loading加载中的开关Booleanfalse

    Switch events

    事件名说明返回值
    on-change开关变化时触发,返回当前的状态true | false

    Switch slot

    名称说明
    open自定义显示打开时的内容
    close自定义显示关闭时的内容