当前位置:首页 > 前端教程

elementui switch

2026-01-15 19:34:46前端教程

ElementUI Switch 组件使用指南

ElementUI 的 Switch 组件是一个开关选择器,常用于状态切换场景(如启用/禁用)。以下是详细使用方法及常见配置:

基本用法

通过 v-model 绑定布尔值控制开关状态:

<el-switch v-model="value"></el-switch>
export default {
  data() {
    return {
      value: true
    }
  }
}

自定义样式

设置 active-colorinactive-color 修改颜色:

<el-switch
  v-model="value"
  active-color="#13ce66"
  inactive-color="#ff4949">
</el-switch>

文字描述

使用 active-textinactive-text 添加文字:

<el-switch
  v-model="value"
  active-text="启用"
  inactive-text="禁用">
</el-switch>

禁用状态

添加 disabled 属性禁用开关:

<el-switch v-model="value" disabled></el-switch>

事件处理

监听 change 事件处理状态变化:

<el-switch v-model="value" @change="handleChange"></el-switch>
methods: {
  handleChange(val) {
    console.log('开关状态变为:', val);
  }
}

扩展配置

设置 width 调整宽度(单位 px):

<el-switch v-model="value" width="60"></el-switch>

表单验证

结合 el-form 进行验证:

elementui switch

<el-form :model="form" :rules="rules">
  <el-form-item label="状态" prop="status">
    <el-switch v-model="form.status"></el-switch>
  </el-form-item>
</el-form>

注意事项

  1. 当与 el-form 联用时,需确保 v-model 绑定的值类型为布尔值
  2. 文字描述的宽度会自动适应,但过长文本可能导致布局问题
  3. 在移动端使用时建议增加点击区域

ElementUI Switch 组件支持所有原生 DOM 事件,可通过 .native 修饰符监听。

标签: elementuiswitch
分享给朋友:

相关文章

elementui获取input的值

elementui获取input的值

获取 input 值的常用方法 在 Element UI 中,可以通过 v-model 双向绑定或 ref 引用的方式获取 input 组件的值。 使用 v-model 双向绑定 <temp…

elementui重构

elementui重构

Element UI 重构指南 Element UI 是一款基于 Vue.js 的组件库,重构通常涉及版本升级、性能优化或代码结构调整。以下是常见的重构方法和注意事项: 升级至 Element Pl…

elementui button

elementui button

基本用法 Element UI 的 Button 组件提供多种样式和功能,可以通过 type 属性设置按钮类型。常见类型包括 primary、success、info、warning、danger。…

elementui title

elementui title

ElementUI 的 Title 相关组件及用法 ElementUI 提供了多种与标题(Title)相关的组件和配置选项,适用于不同场景的需求。以下是常见的使用方法和组件介绍: 对话框(Dia…

elementui tooltip

elementui tooltip

Element UI Tooltip 组件使用指南 Element UI 的 Tooltip 组件用于在鼠标悬停时显示提示信息,常用于解释按钮、图标或其他交互元素的功能。 基本用法 通过 el-to…

elementui中文

elementui中文

Element UI 中文资源 Element UI 是一款基于 Vue.js 的桌面端组件库,提供丰富的 UI 组件和友好的开发体验。以下是关于 Element UI 的中文资源和使用方法: 官方…