Skip to main content

EmployeeField Employee Search Field

When to Use

  • When we need to specify a processor in a page;
  • When users need to register personal information;

Component Example

Component Properties

属性说明类型默认值
beforeSearch

Search personnel, before sending the request, parameters can be processed through this function, effective when the dataType property is url

(params: Record<string, string>) => Record<string, string>

-
beforeSearchTeam

Search organization, before sending the request, parameters can be processed through this function, effective when the dataType property is url

(params: Record<string, string>) => Record<string, string>

-
behavior

表单组件显示状态

Behavior

'NORMAL'

closeOnSelect

Whether to close after selection

boolean

false

dataSource

Personnel data, effective when dataType is dataSource

any[]

-
dataType

Data type, url: interface request, DataSource: data source

'url' | 'dataSource'

'url'

emplIdInLabel

Whether to display employee ID in selected results

boolean

true

fetchDataOnMount

Whether to automatically request interface after page load

boolean

true

fit

Async data result processing, effective when the dataType property is url

(response: any) => any

-
hasClear

Show clear button

boolean

true

hasOrderNum

Show main and part-time positions

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取值为 textrender 时生效

string

-
labelTipsRender

表单组件标题提示信息自定义渲染方法,当labelTipsTypes取值为 render 时生效

(props: IComponentProps) => ReactNode

-
labelTipsText

表单组件标题提示文本信息,当labelTipsTypes取值为 text 时生效

string

-
labelTipsTypes

表单组件标题提示信息类型设置

LabelTipsTypes

'none'

multiple

Enable multi-select mode

boolean

false

orderNum

"When set to 0, it is employee selection mode (only displays main position information), non-zero is position selection mode (shows multiple concurrent position information)"

string

-
placeholder

Employee search field placeholder hint

string

'Please Select'

renderOption

Custom option rendering field

(option: any) => string

-
renderSelection

Custom rendering field after selection

(option: any) => string

-
searchDelay

Search delay, unit in ms

number

100

showAllSub

Show all members

boolean

-
showAvater

Whether to show avatar in selection popup

boolean

true

showDeptDesc

Whether to show department description

boolean

true

showEmplId

Employee search field shows employee ID

boolean

false

showJobDesc

Whether to show job description

boolean

true

showSub

Show subordinates

boolean

false

size

表单组件尺寸

Size

'medium'

subUrl

Subordinate async interface, custom search for all members and subordinates service URL, defaults to interface address

string

-
tips

表单组件描述信息,展示在控件下方

string

-
url

Personnel information async interface address, effective when the dataType property is url

string

-
validation

表单组件校验设置,具体使用详见表单校验文档

Validation[]

[]

value

Current component default value

any[]

-
wrapperColOffset

设置表单组件的偏移位置,设置值为栅格值,1代表1/24

number

0

wrapperColSpan

设置表单组件的占位宽度,设置值为栅格值,1代表1/24

number

0

This doc is generated using machine translation. Any discrepancies or differences created in the translation are not binding and have no legal effect for compliance or enforcement purposes.
© 2014–2025 DingTalk Technology Co., Ltd