ESelectRow
是针对后端数据的下拉查询组件,包括一般的列表下拉和层叠(树结构)下拉。它的 value
总是字符串(单选)或字符串数组(多选情况下)。它是基于 ESelect、ECascader 来实现的。在使用 ESelectRow 时,需要注意以下事项:
- 后端接口需要遵守一定的规范。请求参数要支持 term、offset、limit、sort,响应参数中必须包含
data: {total: N, rows: []}
。其中行数据(row)必须包含id
属性。 - 后端要支持类似
in
的筛选,对应filter
示例如{items: [{field: 'id', op: 'eq', value: ['xxx', 'yyy']}]}
。这个用于查询value
对应的选项。 value
总是字符串或字符串数组。如果需要获得行数据对象,请使用 ESelect、EPickList 等组件。optionValue
默认为row => ({ id: row.id, name: row.name })
,也就是说假定了name
作为显示值。如果不是,则给其定义一个新值,如row => ({ id: row.id, title: row.title })
。
# 下拉列表
是对 ESelect
的封装。动态列表,默认带筛选、无限加载。接口需要返回 data: {total: N, rows: []}
。
如果下面的下拉列表没有数据或报权限不够,请确保您已登录 Engage 集成环境,并且具有管理员角色(即能看到员工管理)。
# 下拉列表 - 文本框内容自定义
如果需要自定义文本框显示的内容,使用名称为 selected
的 slot
定制。
如果下面的下拉列表没有数据或报权限不够,请确保您已登录 Engage 集成环境,并且具有管理员角色(即能看到员工管理)。
# ESelectRow
的 EField
版
# 支持自定义请求参数
设置组件的 overrideRequestOptions
属性,该属性支持传入一个方法,这个方法的参数类型是 Object 类型,字段为原请求的各个参数,返回值要求是自定义之后的请求参数对象。
# 级联下拉列表
是对 ECascader
的封装。默认带筛选。接口需要返回树形结构数组,如 data: [{id, name, children: [{id, name}]}]
。
如果下面的下拉列表没有数据或报权限不够,请确保您已登录 Engage 集成环境,并且具有管理员角色(即能看到组织部门)。
# ESelectRow
# Props
Name | Description | Type | Required | Default |
---|---|---|---|---|
value | 绑定值,v-model 和 value 都可以使用 | String / Array | false | - |
url | 接口 URL,必须是完整 URL(含域名) | String | true | - |
type | 类型,list 表示一般列表,lists、tree 表示级联列表(参考 ECascader) | String | false | list |
optionValue | 候选项 value 获取方式 | Function | false | row => { |
id: row.id,
name: row.name
}|
|overrideRequestOptions|请求参数的设置|Function
|false
|-|
# Events
Event Name | Description | Parameters |
---|---|---|
input | - | - |
# Slots
Name | Description | Default Slot Content |
---|---|---|
name | - | - |
name | - | - |