filter 过滤器

使用

import { KFilter } from "@ksware/ksw-ux";

基本示例

如果需要自定义自定义过滤条件，可以通过配置项的 options 属性配置自定义过滤条件。

过滤时支持自定义多选，通过配置项的 multiple 属性开启多选，支持 select 和 tree-select 控件类型。

multiple 为 true 或 select 时，将会启用多选 select 控件

multiple 为 tree-select 时，将会启用多选 tree-select 控件

配置项的 dataType 属性为 date 时，可以通过 date-format 属性或者配置项的 valueFormat 属性格式化日期。

使用 date-format 属性全局配置格式化日期

通过配置项的 valueFormat 属性为该项单独配置格式化日期

参数名	描述	类型	默认值
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 1.1.23	是否开启精简模式，日期选择时仅支持选择日期范围，如需要精确时间，请将该参数设置为 false	`boolean`	`true`

事件名	描述	类型
confirm	确认筛选条件时触发	`Function`
clear	清除筛选条件时触发	`Function`

插槽名	描述	参数
reference	触发 Popover 显示的 HTML 元素	`object`