SearchField 搜索字段
基于 Element Plus 的搜索表单字段组件,支持多种搜索类型,如文本、数字、日期、选择等。
基础用法
基础的搜索字段用法,支持常见的搜索类型。
支持的类型
事件监听
自定义内容
可以通过插槽自定义字段的展示内容。
API
SearchField 属性
属性名 | 说明 | 类型 | 默认值 |
---|---|---|---|
v-model | 绑定值 | any | - |
slot | 是否使用插槽自定义内容 | boolean / string | false |
type | 搜索类型 | enum | 'input' |
data | 选项数据 | array | [] |
option-value-key | data选项值value key属性名 | string | value |
option-label-key | data选项值label key属性名 | string | label |
props | 组件其它属性对象,具体参照element-plus对应组件的属性文档,也可直接设置组件属性然后透传给组件。 | object | {} |
events | 组件events对象,具体参照element-plus对应组件的事件文档,也可直接设置组件事件然后透传给组件。 | object | {} |
SearchField 插槽
插槽名 | 说明 | 作用域 |
---|---|---|
default | 自定义默认内容,必须设置slot属性 | - |
注意事项
- 不同类型的搜索字段支持的属性可能不同
- 选项数据的格式需要包含 label 和 value 属性,或通过 optionValueKey、optionLabelKey 来指定
- 自定义展示时需要自行处理数据绑定
- 日期类型的值格式需要注意处理
- 搜索字段会自动触发表单的搜索事件
类型定义
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>;
}