EmployeeField 人员搜索框 - DingTalk Help Center

何时使用

当我们需要在页面中指定处理人的时候；
当用户需要登记个人信息的时候；

组件示例

组件属性

属性	说明	类型	默认值
`beforeSearch`	搜索人员，发送请求前，可以通过此函数处理参数，当dataType属性为 url时生效	`(params: Record<string, string>) => Record<string, string>`	-
`beforeSearchTeam`	搜索组织，发送请求前，可以通过此函数处理参数，当dataType属性为 url时生效	`(params: Record<string, string>) => Record<string, string>`	-
`behavior`	表单组件显示状态	Behavior	`'NORMAL'`
`closeOnSelect`	是否在选中后关闭	`boolean`	`false`
`dataSource`	人员数据，当dataType 为 dataSource 时生效	`any[]`	-
`dataType`	数据类型，url：接口请求、DataSource：数据源	`'url' \| 'dataSource'`	`'url'`
`emplIdInLabel`	是否将工号显示在选中结果中	`boolean`	`true`
`fetchDataOnMount`	是否在页面加载后自动请求接口	`boolean`	`true`
`fit`	异步数据结果处理，当dataType属性为 url时生效	`(response: any) => any`	-
`hasClear`	显示清除按钮	`boolean`	`true`
`hasOrderNum`	显示主兼职	`boolean`	-
`hiddenSelected`	-	`boolean`	-
`label`	表单组件标题	`string`	-
`labelAlign`	表单组件标题的位置	`'left' \| 'top'`	`'top'`
`labelColOffset`	设置标题的偏移位置，配置值为栅格值，1代表1/24	`number`	`0`
`labelColSpan`	设置标题的占位宽度，配置值为栅格值，1代表1/24	`number`	`4`
`labelTextAlign`	表单组件的标题对齐方式	`'left' \| 'right'`	`'right'`
`labelTipsIcon`	表单组件标题提示信息入口图标，当labelTipsTypes取值为 text 或 render 时生效	`string`	-
`labelTipsRender`	表单组件标题提示信息自定义渲染方法，当labelTipsTypes取值为 render 时生效	`(props: IComponentProps) => ReactNode`	-
`labelTipsText`	表单组件标题提示文本信息，当labelTipsTypes取值为 text 时生效	`string`	-
`labelTipsTypes`	表单组件标题提示信息类型设置	LabelTipsTypes	`'none'`
`multiple`	开启多选模式	`boolean`	`false`
`orderNum`	”为 0 时为选人模式（仅展示主岗信息），非 0 为选岗模式（透出多个兼岗信息）“	`string`	-
`placeholder`	人员搜索框占位提示	`string`	`'请选择'`
`renderOption`	自定义选项渲染字段	`(option: any) => string`	-
`renderSelection`	自定义选中后的渲染字段	`(option: any) => string`	-
`searchDelay`	搜索延时，单位ms	`number`	`100`
`showAllSub`	显示全员	`boolean`	-
`showAvater`	是否在选择浮窗中显示头像	`boolean`	`true`
`showDeptDesc`	是否显示部门描述	`boolean`	`true`
`showEmplId`	人员搜索框显示工号	`boolean`	`false`
`showJobDesc`	是否显示职位描述	`boolean`	`true`
`showSub`	显示下属	`boolean`	`false`
`size`	表单组件尺寸	Size	`'medium'`
`subUrl`	下属异步接口，自定义搜索全员和下属时的服务 URL，默认用接口地址	`string`	-
`tips`	表单组件描述信息，展示在控件下方	`string`	-
`url`	人员信息异步接口地址，当dataType属性为 url时生效	`string`	-
`validation`	表单组件校验设置，具体使用详见表单校验文档	Validation[]	`[]`
`value`	当前组件默认值	`any[]`	-
`wrapperColOffset`	设置表单组件的偏移位置，设置值为栅格值，1代表1/24	`number`	`0`
`wrapperColSpan`	设置表单组件的占位宽度，设置值为栅格值，1代表1/24	`number`	`0`