Skip to content

SearchField 搜索字段

基于 Element Plus 的搜索表单字段组件,支持多种搜索类型,如文本、数字、日期、选择等。

基础用法

基础的搜索字段用法,支持常见的搜索类型。

支持的类型

事件监听

自定义内容

可以通过插槽自定义字段的展示内容。

API

SearchField 属性

属性名说明类型默认值
v-model绑定值any-
slot是否使用插槽自定义内容boolean / stringfalse
type搜索类型enum'input'
data选项数据array[]
option-value-keydata选项值value key属性名stringvalue
option-label-keydata选项值label key属性名stringlabel
props组件其它属性对象,具体参照element-plus对应组件的属性文档,也可直接设置组件属性然后透传给组件。object{}
events组件events对象,具体参照element-plus对应组件的事件文档,也可直接设置组件事件然后透传给组件。object{}

SearchField 插槽

插槽名说明作用域
default自定义默认内容,必须设置slot属性-

注意事项

  1. 不同类型的搜索字段支持的属性可能不同
  2. 选项数据的格式需要包含 label 和 value 属性,或通过 optionValueKey、optionLabelKey 来指定
  3. 自定义展示时需要自行处理数据绑定
  4. 日期类型的值格式需要注意处理
  5. 搜索字段会自动触发表单的搜索事件

类型定义

ts
interface SearchFieldProps {
    modelValue?: any;
    type?: string;
    slot?: string | boolean;
    data?: Array<Record<string, any>>;
    optionValueKey?: string;
    optionLabelKey?: string;
    props?: Record<string, any>;
    events?: Record<string, any>;
}

基于 MIT 许可发布