search相关-ulthon

搜索表单生成器

提供快捷搜索表单生成器，根据table表格初始化时的列参数进行动态生成。

参数	说明	类型	是否必填	默认值	备注
search	搜索类型	string/bool	否	true	可用值，请参考下方参数说明
searchOp	搜索条件	string	否	%*%	可用值，请参考下方参数说明
searchTip	搜索提示语	string	否		默认获取title参数值自动生成
searchValue	表单初始化值	string	否		这个值仅仅初始化搜索的表单默认项,不会再初始化时传递给接口
selectList	下拉列表值	object	否		需要search参数等于select时才生效
fieldAlias	字段别名	string	否	与field参数相等	某些特殊情况下才需要，正常用不上，用于给搜索表单生成，详细规则见下面
defaultSearchValue	默认搜索	string	否		这个值会在初始化表格时影响表格搜索结果,并且如果没有设置`searchValue`的话,会自动初始化
searchHide	默认搜索	string	否	false	是否在搜索表单中隐藏该项,开启之后,搜索表单中会隐藏,用户无法操作他,但是其他搜索配置正常,依然可以用接口或初始化的方式使用

defaultSearchValue 的更多用法请查看默认搜索筛选

search 搜索类型：
- false 关闭搜索
- true 开启搜索
- select 下拉选择
- range 时间范围
- time 时间格式
- time_limit 时间范围，大小值独立选择的，此时searchOp无效
- number_limit 数字数字范围，大小值独立设置，此时searchOp无效
searchOp 搜索条件：
- = 精确搜索
- %*% 模糊搜索
- *% 右匹配模糊搜索
- %* 左匹配模糊搜索
- range 范围搜索
- min 最小值
- max 最大值
- min_date 最小日期
- min_date 最大日期

fieldAlias

该字段的值会用于生成表单搜索中的input的name项。
比如表格读取的字段是：create_time，fieldAlias可以填写create_time_range，这样提交搜索的时候，就会使用create_time_range，搜索。

但是这样似乎没有什么用处，实际上他还支持更多的操作，比如：设置search为plus,然后这样写：[create_time]1,这样会以[create_time]1提交数据，此时与原本的create_time会同时存在，同时提交到后台，然后触发search-op的条件。

比如这样的代码：

{ field: 'id', title: 'id', search: 'number_limit' },
{ field: 'id', title: 'id模糊匹配', trueHide: true, fieldAlias: '[id]like' },
{ field: 'id', title: '最大id', trueHide: true, fieldAlias: '[id]max', searchOp: 'max' },

最终效果，会根据首先会根据id的number_limit的条件进行搜索，同时会根据[id]like再进行一个%*%模糊搜索。然后再根据[id]min，进行一个max条件搜索。

上面案例中的like，max都是自定义的，只要不重复就可以提交到接口中。

也就是说同一个字段，我们可以设置多个搜索项。搭配trueHide设置，这一列便不会在表格中显示。

上面案例中没有设置searchOp，但是它的默认项是%*%

上面的例子其实就是系统中的日志管理，可以前往体验。

代码示例

cols: [[
        {type: "checkbox"},
        {field: 'id', width: 80, title: 'ID'},
        {field: 'sort', width: 80, title: '排序', edit: 'text'},
        {field: 'title', minWidth: 80, title: '商品名称'},
        {field: 'logo', minWidth: 80, title: '分类图片', search: false, templet: ua.table.image},
        {field: 'status', title: '状态', width: 85, selectList: {0: '禁用', 1: '启用'}, templet: ea.table.switch},
        {field: 'create_time', minWidth: 80, title: '创建时间', search: 'range'},
    ]],