[前端][ejs] ejs.contact.select 选择人员

移动前端框架目前提供了两种风格的H5选人组件：

（1）依赖于MUI框架的选人组件，使用框架版本要大于等于F942。该组件传参与EJS原生选人组件一致，具体传参请看：EJS选人API文档。以下简称M7选人组件。

（2）依赖于vue和vant的选人组件，使用框架版本要大于等于F950，该组件同样兼容F942接口，可配置进行切换。传参与M7选人组件有较大差异，具体传参请看：M8选人组件。以下简称M8选人组件。

版本信息

EJS选人API

• 在EJS版本号3.5.0 ~ 3.5.1 及 4.0.0 ~ 4.1.9-sp3之间，EJS框架都内置了M7选人组件，可直接通过 ejs.contact.select进行调用。

• 在EJS版本号3.5.2及以上、4.2.0及以上，不再内置M7选人组件，而是将该组件拆分出来，作为一个单独的UI组件内置在M7框架中。

EJS框架删除M7选人组件后，页面上无法通过单独调用ejs.contact.select来调用H5选人，必须先从M7或M8框架中引入H5选人组件，二者配合调用。

• 在EJS客户端，调用ejs.contact.select始终默认调用原生选人组件。

M7框架内置的选人组件

• M7框架7.5.4之前，调用H5选人直接通过ejs.contact.select调用即可，要求EJS版本号在3.5.0 ~ 3.5.1 或 4.0.0 ~ 4.1.9-sp3之间。

• 在版本7.5.4，M7框架更新了这两个EJS版本：3.5.2、4.2.0。

且自7.5.4开始，M7框架内置两种风格的选人组件：M7选人组件 和 M8选人组件。

以上两种选人组件引入页面后，都可以通过ejs.contact.select进行调用，要求EJS版本号在3.5.2及以上或者4.2.0及以上。

需要注意，两种组件传参有较大差异，所以使用M8选人组件时，推荐直接调用组件提供的全局函数SelectPerson，不推荐通过ejs.contact.select进行调用，因为在EJS客户端中默认调用原生选人组件，传参的差异会导致问题。

具体请看M7框架文档：M7内置选人组件

M8框架内置的选人组件

• M8框架版本8.0.1 ~ 8.2.14，若要使用H5的选人组件，只能使用旧版本EJS的选人API，要求EJS版本号在4.0.0 ~ 4.1.9-sp3之间(EJSv3版本在M8框架中适配性较差，不推荐使用)。

相关的知识库可参考：M8框架调用基于MUI框架的H5选人

知识库中的资源请在此下载：

mui资源

H5contact配置文件

• M8框架自8.2.15开始，内置了依赖于vue和vant的M8选人组件，页面可直接引入该组件调用H5选人功能。

若想要在EJS客户端调用原生选人组件，在其他环境调用H5选人，只能通过ejs.os判断环境，在EJS客户端调用ejs.contact.select，在其他环境调用组件函数。

若只需调用H5选人时，当然也可以通过ejs.contact.select来调用选人组件，但这有前提条件：

1. 要求EJS版本号在4.2.0及以上

2. 引入M8选人组件后，需要将组件函数绑定全局：

import SelectPerson from '@components/selectperson';

window.SelectPerson = SelectPerson;

3. 调用ejs.contact.select时，需要将M8选人组件的参数全部设置一遍。

由于传参的差异，始终不推荐通过ejs.contact.select来调用M8选人组件。