a026f10056
* docs(components): adjust description of Switch props #4297 * docs(components): update description of inline-prompt prop #4297 * docs(components): amend wording #4297
6.4 KiB
title, lang
| title | lang |
|---|---|
| Switch | en-US |
Switch
Switch is used for switching between two opposing states.
<style lang="scss"> .example-showcase { .el-switch + .el-switch { margin-left: 10px; } } </style>Basic usage
:::demo Bind v-model to a Boolean typed variable. The active-color and inactive-color attribute decides the background color in two states.
switch/basic
:::
Text description
You can add active-text and inactive-text attribute to show texts. use inline-prompt attribute to control text is displayed inside dot.
:::demo You can add active-text and inactive-text attribute to show texts.
switch/text-description
:::
Display custom icons
:::tip
Use the active-icon and active-icon attribute to add icon. You can pass either string for the component name (registered in advance) or the component itself which is a SVG Vue component. Element Plus has provided a set of icon that you can find at icon
:::
:::demo You can add active-icon and inactive-icon attribute to show icons. use inline-prompt attribute to control icon is displayed inside dot.
switch/custom-icons
:::
Extended value types
:::demo You can set active-value and inactive-value attributes. They both receive a Boolean, String or Number typed value.
switch/extended-value-types
:::
Disabled
:::demo Adding the disabled attribute disables Switch.
switch/disabled
:::
Loading
:::demo Setting the loading attribute to true indicates a loading state on the Switch.
switch/loading
:::
prevent switching
:::demo set the before-change property, If false is returned or a Promise is returned and then is rejected, will stop switching.
switch/prevent-switching
:::
Attributes
| Attribute | Description | Type | Accepted Values | Default |
|---|---|---|---|---|
| model-value / v-model | binding value, it should be equivalent to either active-value or inactive-value, by default it's boolean type |
boolean / string / number | — | — |
| disabled | whether Switch is disabled | boolean | — | false |
| loading | whether Switch is in loading state | boolean | — | false |
| width | width of Switch | number | — | 40 |
| inline-prompt | whether icon or text is displayed inside dot, only the first character will be rendered for text | boolean | — | false |
| active-icon | component of the icon displayed when in on state, overrides active-text |
string / Component | — | — |
| inactive-icon | component of the icon displayed when in off state, overrides inactive-text |
string / Component | — | — |
| active-text | text displayed when in on state |
string | — | — |
| inactive-text | text displayed when in off state |
string | — | — |
| active-value | switch value when in on state |
boolean / string / number | — | true |
| inactive-value | switch value when in off state |
boolean / string / number | — | false |
| active-color | background color when in on state |
string | — | #409EFF |
| inactive-color | background color when in off state |
string | — | #C0CCDA |
| border-color | border color of the switch | string | — | — |
| name | input name of Switch | string | — | — |
| validate-event | whether to trigger form validation | boolean | — | true |
| before-change | before-change hook before the switch state changes. If false is returned or a Promise is returned and then is rejected, will stop switching |
function | — | — |
Events
| Event Name | Description | Parameters |
|---|---|---|
| change | triggers when value changes | value after changing |
Methods
| Method | Description | Parameters |
|---|---|---|
| focus | focus the Switch component | — |