> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# EmployeeField 人员搜索框

> EmployeeField 人员搜索框组件文档，详解人员数据源、搜索请求钩子与选择限制等属性，用于在表单中选择组织内成员。

## 何时使用

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

## 组件示例

<iframe src="https://www.aliwork.com/developer/employee-field-v2?isRenderNav=false" width="100%" height="480" frameBorder="0" />

## 组件属性

| 属性                 | 说明                                                              | 类型                                                                  | 默认值        |
| ------------------ | --------------------------------------------------------------- | ------------------------------------------------------------------- | ---------- |
| `beforeSearch`     | 搜索人员，发送请求前，可以通过此函数处理参数，当**dataType**属性为 url时生效                  | `(params: Record<string, string>) => Record<string, string>`        | -          |
| `beforeSearchTeam` | 搜索组织，发送请求前，可以通过此函数处理参数，当**dataType**属性为 url时生效                  | `(params: Record<string, string>) => Record<string, string>`        | -          |
| `behavior`         | 表单组件显示状态                                                        | [Behavior](/zh/open/yida/components/interface#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](/zh/open/yida/components/interface#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](/zh/open/yida/components/interface#size)                     | `'medium'` |
| `subUrl`           | 下属异步接口，自定义搜索全员和下属时的服务 URL，默认用 接口地址                              | `string`                                                            | -          |
| `tips`             | 表单组件描述信息，展示在控件下方                                                | `string`                                                            | -          |
| `url`              | 人员信息异步接口地址，当**dataType**属性为 url时生效                              | `string`                                                            | -          |
| `validation`       | 表单组件校验设置，具体使用详见[表单校验文档](/zh/open/yida/guide/concept/validation) | [Validation\[\]](/zh/open/yida/components/interface#validation)     | `[]`       |
| `value`            | 当前组件默认值                                                         | `any[]`                                                             | -          |
| `wrapperColOffset` | 设置表单组件的偏移位置，设置值为栅格值，1代表1/24                                     | `number`                                                            | `0`        |
| `wrapperColSpan`   | 设置表单组件的占位宽度，设置值为栅格值，1代表1/24                                     | `number`                                                            | `0`        |