参照 Refer

参照组件提供固定的几种界面样式（列表， 树， 树表， 下拉），用户可以按照规定的形式提供参数，即可实现完整的交互逻辑。

1. 何时使用

使用参照的场景通常满足以下几个要求。第一，用户需要填写的数据不可以随意填写，且已经存在于数据库。第二，这些数据是一些常用和固定的数据，如组织、部门、人员、岗位等。第三，用户在选择数据时需要进行权限过滤，以防止用户越权选择自己无权管理的数据。

2. 如何使用

  1. import { high } from 'nc-lightapp-front';
  2. const { Refer } = high;

4. API

参数 说明 类型 默认值
value 参照的值（和foolValue之一必输） object （无）
foolValue 参照的值（和value之一必输） object （无）
onChange 选中参照后的回调（必输） function(value) （无）
refName 弹出层参照的标题 string ‘’
refType 参照类型（grid/tree/gridTree） string ‘grid’
type 参照展示类型（popover/dropDown） string ‘popover’
columnConfig 配置多级菜单以及参照展示列 array [{name: [ ‘编码’, ‘名称’ ],code: [ ‘refcode’, ‘refname’ ]}]
treeConfig 配置树的展示 object {name: [ ‘名称’ ],code: [ ‘refname’ ]}
hotDataSize 历史记录条数 number 10
pageSize 分页请求数据时每页条数 number 10
disabled 是否禁用 boolean false
referClassName 参照最外层的class string ‘’
className 参照input的class string ‘’
style 参照最外层的样式 object {}
placeholder 占位文字 string ‘’
showHistory 获取焦点时，是否显示历史记录 boolean true
queryGridUrl 查询表数据的请求url string ‘’
queryTreeUrl 查询树数据的请求url string ‘’
clickContainer 指定点击可以触发参照弹窗的元素 object null
queryCondition return一个对象，作为请求参数的一部分传给后台 function object
isCacheable 是否启用数据缓存 boolean true
container 容器 DOMNode document.body
isMultiSelectedEnabled 是否多选 boolean false
onTreeNodeExpand 树节点展开事件 function function (node) {}
maxCacheNum 缓存条数 number 10
rootNode 树的根节点 object { refname: ‘根节点’, refpk: ‘root’ }
autoFocus 自动获取焦点 boolean false
onBlur 失去焦点事件 function function() {}
onFocus 获取焦点的事件 function function () {}
onlyLeafCanSelect 是否只有叶子节点可选 boolean false
isTreelazyLoad 树是否是懒加载 boolean true
allowSearchConfig 是否显示搜索设置 boolean false
allowColumnConfig 是否显示列设置 boolean true
fieldDisplayed 作为display的字段 string/array ‘refname’
fieldValued 作为value的字段 string/array ‘refpk’
isShowDisabledData 是否显示停用数据 boolean true
isHasDisabledData 是否有【显示停用】功能 boolean true
unitProps 传给参照中业务单元参照的props，和参照的属性一样 object null
unitCondition 业务单元参照的过滤条件 function\ object
isShowUnit 是否显示业务单元，仅当isShowUnit && unitProps时，才显示业务单元 boolean true
checkStrictly 严格的检查每一条数据。为true时，只有具体选中某条数据才会选中；false时，会选中输入的值 boolean false
popWindowClassName 添加到弹出层的class string ‘’
idKey 树id对应的key值 string ‘refpk’
pidKey 树pid对应的key值 string ‘pid’
rowKey 表格行对应的key值 string ‘refpk’
isShowUsual 树表参照是否显示【常用】 boolean false
defaultUnitValue 业务单元默认值 object {}
isShowTableSearch 显示表格区的搜索框 boolean true
isShowTreeSearch 显示树区的搜索框 boolean true
functions 参照函数 array []
showTitle 鼠标悬停时是否显示title boolean true
isRunWithChildren 是否启用【执行时包含下级】功能 boolean false
isAlwaysEmitOnChange 是否始终触发onChange事件 boolean false
unitValueIsNeeded 只有选业务单元才会发请求 boolean false
tabIndex 参照的tabindex number 0
baseTabIndex tabIndex基于此值往上加 number 0
onClick 参照的点击事件 function function() {}
needFocusOnClose 关闭后是否需要获取焦点 boolean true
dropDownPlacement 同dropdown组件的placement属性 string ‘bottomLeft’
dropDownTitleConfig 下拉标题设置 object null
maxChoice 最多选择的数据条数 number 1000
async 请求是否异步 boolean true