> ## 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 User Search Box

> EmployeeField User Search Box component documentation, covering User data source, search request hooks, and selection restrictions, used to select organization members within forms.

## When to Use

* To specify a handler on a page.
* To let users register Profile information.

## Component Example

## Component Properties

| Attribute          | Description                                                                                                                                                                | Type                                                             | Default           |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | ----------------- |
| `beforeSearch`     | Processes parameters before sending a search request for users. Takes effect when the **dataType** attribute is url.                                                       | `(params: Record<string, string>) => Record<string, string>`     | -                 |
| `beforeSearchTeam` | Processes parameters before sending a search request for organizations. Takes effect when the **dataType** attribute is url.                                               | `(params: Record<string, string>) => Record<string, string>`     | -                 |
| `behavior`         | Form component display status.                                                                                                                                             | [Behavior](/open/yida/components/interface#behavior)             | `'NORMAL'`        |
| `closeOnSelect`    | Whether to Close after selection.                                                                                                                                          | `boolean`                                                        | `false`           |
| `dataSource`       | User Data. Takes effect when **dataType** is dataSource.                                                                                                                   | `any[]`                                                          | -                 |
| `dataType`         | Data type. url: HTTP URL request; DataSource: Data Source.                                                                                                                 | `'url' \| 'dataSource'`                                          | `'url'`           |
| `emplIdInLabel`    | Whether to display Employee ID in Selected results.                                                                                                                        | `boolean`                                                        | `true`            |
| `fetchDataOnMount` | Whether to automatically request the HTTP URL after page load.                                                                                                             | `boolean`                                                        | `true`            |
| `fit`              | Async Data result processing. Takes effect when the **dataType** attribute is url.                                                                                         | `(response: any) => any`                                         | -                 |
| `hasClear`         | Displays the clear Button.                                                                                                                                                 | `boolean`                                                        | `true`            |
| `hasOrderNum`      | Displays primary and concurrent positions.                                                                                                                                 | `boolean`                                                        | -                 |
| `hiddenSelected`   | -                                                                                                                                                                          | `boolean`                                                        | -                 |
| `label`            | Form component Title.                                                                                                                                                      | `string`                                                         | -                 |
| `labelAlign`       | Position of the form component Title.                                                                                                                                      | `'left' \| 'top'`                                                | `'top'`           |
| `labelColOffset`   | Sets the offset position of the Title. The value is a grid unit, where 1 represents 1/24.                                                                                  | `number`                                                         | `0`               |
| `labelColSpan`     | Sets the placeholder width of the Title. The value is a grid unit, where 1 represents 1/24.                                                                                | `number`                                                         | `4`               |
| `labelTextAlign`   | Align method for the form component Title.                                                                                                                                 | `'left' \| 'right'`                                              | `'right'`         |
| `labelTipsIcon`    | Entry icon for form component Title Tips information. Takes effect when labelTipsTypes is **text** or **render**.                                                          | `string`                                                         | -                 |
| `labelTipsRender`  | Custom render method for form component Title Tips information. Takes effect when labelTipsTypes is **render**.                                                            | `(props: IComponentProps) => ReactNode`                          | -                 |
| `labelTipsText`    | Text of the form component Title Tips information. Takes effect when labelTipsTypes is **text**.                                                                           | `string`                                                         | -                 |
| `labelTipsTypes`   | Type Settings for form component Title Tips information.                                                                                                                   | [LabelTipsTypes](/open/yida/components/interface#labeltipstypes) | `'none'`          |
| `multiple`         | Turns On Multiselect mode.                                                                                                                                                 | `boolean`                                                        | `false`           |
| `orderNum`         | When 0, uses User selection mode (displays only primary position information). When non-zero, uses position selection mode (exposes multiple concurrent position details). | `string`                                                         | -                 |
| `placeholder`      | Placeholder Tips for the User search box.                                                                                                                                  | `string`                                                         | `'Please Select'` |
| `renderOption`     | Custom option render Field.                                                                                                                                                | `(option: any) => string`                                        | -                 |
| `renderSelection`  | Custom render Field after selection.                                                                                                                                       | `(option: any) => string`                                        | -                 |
| `searchDelay`      | Search delay, in ms.                                                                                                                                                       | `number`                                                         | `100`             |
| `showAllSub`       | Displays all members.                                                                                                                                                      | `boolean`                                                        | -                 |
| `showAvater`       | Whether to display the Profile Photo in the selection popup.                                                                                                               | `boolean`                                                        | `true`            |
| `showDeptDesc`     | Whether to display the Department description.                                                                                                                             | `boolean`                                                        | `true`            |
| `showEmplId`       | Whether the User search box displays Employee ID.                                                                                                                          | `boolean`                                                        | `false`           |
| `showJobDesc`      | Whether to display the Job Title description.                                                                                                                              | `boolean`                                                        | `true`            |
| `showSub`          | Displays subordinates.                                                                                                                                                     | `boolean`                                                        | `false`           |
| `size`             | Form component size.                                                                                                                                                       | [Size](/open/yida/components/interface#size)                     | `'medium'`        |
| `subUrl`           | Async HTTP URL for subordinates. Custom service URL used when searching all members and subordinates. Defaults to the main HTTP URL.                                       | `string`                                                         | -                 |
| `tips`             | Form component description information, displayed below the control.                                                                                                       | `string`                                                         | -                 |
| `url`              | Async HTTP URL for User information. Takes effect when the **dataType** attribute is url.                                                                                  | `string`                                                         | -                 |
| `validation`       | Form component validation Settings. For details, see the [Form validation Document](/open/yida/guide/concept/validation).                                                  | [Validation\[\]](/open/yida/components/interface#validation)     | `[]`              |
| `value`            | Default value of the current component.                                                                                                                                    | `any[]`                                                          | -                 |
| `wrapperColOffset` | Sets the offset position of the form component. The value is a grid unit, where 1 represents 1/24.                                                                         | `number`                                                         | `0`               |
| `wrapperColSpan`   | Sets the placeholder width of the form component. The value is a grid unit, where 1 represents 1/24.                                                                       | `number`                                                         | `0`               |
