Skip to content
On this page

select下拉框组件

https://element-plus.org/zh-CN/component/select.html

Hidden Title

基础用法:<s-select v-model="selectVal" :options="options" title="哈哈"></s-select>

属性事件插槽简介

基础用法

成华主题

chenghua基础用法

chenghua尺寸

chenghua多选

石景山主题

shijingshan基础用法

shijingshan尺寸

shijingshan多选

通常用法

高度

尺寸

多选--隐藏多余标签的多选

调用change方法

遍历调用change方法

集成绝大部分属性和方法

customLabel自定义显示label

解析html

插槽

disabled, 设置选项不允许选择

table单选

table多选

属性

属性名说明类型默认值
modelValue当前值array / string / number-
value选项值字段名stringvalue
label选项显示字段名,支持字符串或多字段数组string / arraylabel
options选项数据array[]
type数据类型,传 simple 时按基础类型数组处理string''
multiple是否多选booleanfalse
showAll多选时是否显示全选/反选booleantrue
showPrefix是否显示前缀数量信息booleanfalse
showQuick是否显示上下快速切换按钮booleantrue
size选择器尺寸,支持 small / default / largestring''
theme选择器主题,支持 default / chenghua / shijingshanstringdefault
title左侧标题文案string''
compTitleStyle左侧标题组件样式object{}
connect多字段 label 拼接符string/
customLabel自定义 label,参数为 { option, index, value }function-
width组件宽度string / number''
height组件高度string / number''
disPlaceholder禁用态占位文案string''
customDisabled自定义禁用,参数为 { option, index, value }(context) => boolean-
url远程请求地址或方法string / function''
urlParams远程请求参数object{}
optionsExpression远程结果取值表达式string''
emptyColor选项为空时是否高亮边框booleanfalse
showTooltip选中项文本溢出时是否显示 tooltipbooleantrue
tooltipAttrs选中项溢出 tooltip 额外属性object{}
dangerouslyUseHTMLString是否将选中项溢出 tooltip 的内容按 HTML 字符串渲染booleanfalse

事件

事件名说明
update:modelValue选中值变化时触发
change值变化时触发
changeSelect组件内部切换选项时触发,参数为 { value, label, option, index };多选时各字段为数组,清空时为 undefined

命名事件函数需要显式标注类型,TypeScript 无法从模板事件反向推断脚本区函数参数。组件库已导出 SSelectChangeContext

ts
import type { SSelectChangeContext } from 'sybz-components'

function changeSelect({ value, label, option, index }: SSelectChangeContext) {
  console.log(value, label, option, index)
}
import type { SSelectChangeContext } from 'sybz-components'

function changeSelect({ value, label, option, index }: SSelectChangeContext) {
  console.log(value, label, option, index)
}

说明

  • 组件基于 el-select 封装,绝大多数原生属性都可以直接透传。
  • 多选模式下支持全选、反选和上下快速切换。

思云博智私有前端组件库