element/examples/docs/en-US/switch.md

Switch

Switch is used for switching between two opposing states.

Basic usage

:::demo Bind v-model to a Boolean typed variable. You can add on-text or off-text attribute to show texts when the component is on or off, respectively. The on-color and off-color attribute decides the background color in two states.

<el-switch
  v-model="value1"
  on-text=""
  off-text="">
</el-switch>
<el-switch
  v-model="value2"
  on-color="#13ce66"
  off-color="#ff4949">
</el-switch>

<script>
  export default {
    data() {
      return {
        value1: true,
        value2: true
      }
    }
  };
</script>

:::

Disabled

:::demo Adding the disabled attribute disables Switch.

<el-switch
  v-model="value3"
  on-text=""
  off-text=""
  disabled>
</el-switch>
<el-switch
  v-model="value3"
  disabled>
</el-switch>

<script>
  export default {
    data() {
      return {
        value3: true
      }
    }
  };
</script>

:::

Attributes

Attribute	Description	Type	Accepted Values	Default
disabled	whether Switch is disabled	boolean	—	false
width	width of Switch	number	—	58 (with text) / 46 (no text)
on-close-icon	class name of the icon displayed when in on state, overrides on-text	string	—	—
off-close-icon	class name of the icon displayed when in off state, overrides off-text	string	—	—
on-text	text displayed when in on state	string	—	ON
off-text	text displayed when in off state	string	—	OFF
on-color	background color when in on state	string	—	#20A0FF
off-color	background color when in off state	string	—	#C0CCDA
name	input name of Switch	string	—	—

Events

Event Name	Description	Parameters
change	triggers when value changes	value after changing