主题
filter 过滤器
使用
基本示例
自定义过滤条件
如果需要自定义自定义过滤条件,可以通过配置项的 options
属性配置自定义过滤条件。
自定义多选过滤
过滤时支持自定义多选,通过配置项的 multiple
属性开启多选,支持 select
和 tree-select
控件类型。
multiple
为 true
或 select
时,将会启用多选 select
控件
multiple
为 tree-select
时,将会启用多选 tree-select
控件
格式化日期
配置项的 dataType
属性为 date
时,可以通过 date-format
属性或者配置项的 valueFormat
属性格式化日期。
使用 date-format
属性全局配置格式化日期
通过配置项的 valueFormat
属性为该项单独配置格式化日期
API
Filter Props
参数名 | 描述 | 类型 | 默认值 |
---|---|---|---|
options | 筛选配置项,包含字段、标题、数据类型、等信息,目前支持的类型有:string、number、date,默认为string | array | - |
data | 待筛选数据,支持传入一个数组数据,筛选时会对该数组进行筛选,通过confirm事件返回筛选后的数据 | any[] | - |
filter-key | 数据筛选字段 | string | title |
children-field | 用于树形数据场景,指定子节点字段名 | string | children |
size | 尺寸 | enum | base |
border | 是否显示默认触发按钮的边框 | boolean | true |
remote | 指定远程筛选字段,设置data属性后生效,为true时默认远程筛选所有字段,也可以指定字段数组 | boolean | string[] | false |
formatter | 用于dataType=date,用于格式化日期值 | string | - |
ignore-case | 是否忽略大小写 | boolean | false |
default-condition | 是否忽略大小写 | boolean | false |
simple-date-display | 是否开启精简模式,日期选择时仅支持选择日期范围,如需要精确时间,请将该参数设置为 false | boolean | true |
Filter Events
事件名 | 描述 | 类型 |
---|---|---|
confirm | 确认筛选条件时触发 | Function |
clear | 清除筛选条件时触发 | Function |
Filter Methods
方法名 | 描述 | 类型 |
---|---|---|
filter | 筛选数据 | Function |
clearFilter | 清除筛选条件 | Function |
getConditionInfo | 获取筛选条件 | Function |
Filter Slots
插槽名 | 描述 | 参数 |
---|---|---|
reference | 触发 Popover 显示的 HTML 元素 | object |