Skip to content

Segmented 组件文档

组件简介

Segmented 是基于 Element Plus 的 <el-segmented /> 组件的二次封装,支持选项分段切换,常用于标签切换、状态切换等场景。
该组件支持 v-model 双向绑定、禁用、动态选项、change 事件等功能。

使用方法

1. 注册组件

直接使用 <GSegmented />

2. 基本用法

loading

Props

属性说明类型默认值
modelValue / v-model当前选中值任意-
options选项数组,格式同 el-segmentedArray-
disabled是否禁用, 一般用于loading状态下时防止用户点击, 可绑定loadingBooleanfalse

其他属性会透传给 el-segmented。

Events

事件名说明回调参数
change选中项变化时value

说明

  • 该组件本质是对 Element Plus 的 <el-segmented /> 的封装,支持所有原生属性和事件。
  • 支持 v-model 绑定当前选中值。
  • 支持通过 options 属性动态传入选项。
  • 支持 disabled 属性禁用全部选项。
  • 选中项变化时会触发 change 事件。

样式

  • 组件样式继承自 Element Plus,并在 element-theme.less 中有部分自定义覆盖。
  • 可通过外部 class/style 进一步自定义。

如需更详细的用法或扩展,请参考 Element Plus 官方文档的 el-segmented