react-contacts

⛔️⛔️⛔️ 请访问 https://gitlab.rd.virsical.cn/virsical/h5/component/react-contacts 进行维护 ⛔️⛔️⛔️

⛔️⛔️⛔️ 相关代码已经同步到了 GitLab 里面，这个库以后不保证为最新内容。⛔️⛔️⛔️

react-contacts

contacts & department select

中文文档

威发微服务选人组件/Wafer microservice selection component

Example

How to use

install

yarn add react-contacts

React

import Contacts from 'react-contacts'

<Contacts {...props}/>

Properties	Description	Type	Default Values
deptTree	Department of Tree（[Department Data](###Department Data)）	array	[]
users	User data （[User & Search Result Data](###User & Search Result Data)）	object	{ records: []}
loading	Loading status	bool	false
searchResult	Query user data return results （[User & Search Result Data](###User & Search Result Data)）	object	{ records: []}
handleSearchUser	Handle search user function	func	function(page,nameKey,depId)
deptSearch	Show department search input	bool	tree
updateSelectUsers	Update user list when select user	func	function(userSelected)
updateSelectDept	Update dept list when select dept	func	function(deptSelected)
deptCheckBox	Show department checkbox	bool	true
searchDeptPlaceholder	search department placeholder	string	'请输入搜索部门'
searchUserPlaceholder	search department placeholder	string	'请输入搜索姓名'
defaultUserSelected	default user selected	array	[{userId:'abc',username:'CCC'}]
defaultDeptSelected	default user selected ([Note](###Department tree initialization data))	array	[{id:1,name:'ABC'}]
numberColor	total number color	sring	#1B9AFF
selectAllText	select all text	string	全选
totalShowText	totalShowText	string	共选择了$个
userNameKey	fetch user name and selected key	string	'username'
deptNameKey	Take the department tree and select the name of the key	string	'name'
radio	show radio on user selected	bool	false
radioShowText	when user selected on radio, show tip text.	string	'已经选择'
checkStrictly	Check treeNode precisely; parent treeNode and children treeNodes are not associated	bool	false
showAllDeptTags	Whether Tags show all nodes	bool	false
returnReducedNode	Department tree data reduction mode ([Department tree initialization data](###Department tree initialization data))	bool	false
showLeft	show Left Panel	bool	true
loadData	Load data asynchronously	function(node) ([Dynamically load the department tree](###Dynamically load the department tree))	false
enNameKey	English name key	string	false
disableUsers	The user ID cannot be selected	array	[]
disableDept	The department ID cannot be selected	array	[]

Department Data

[
      {
        id: 1,
        parentId: 0,
        children: [
          {
            id: 3,
            parentId: 1,
            children: [
              {
                id: 4,
                parentId: 3,
                children: [
                  {
                    id: 5,
                    parentId: 4,
                    children: [],
                    name: '院校农信',
                  },
                ],
                name: '高新农信',
              },
            ],
            name: '潍坊农信',
          },
        ],
        name: '山东农信',
      },
  ]

User & Search Result Data

 {
      records: [
        {
          userId: 1,
          username: 'admin',
          password: '$2a$10$QOfWxxFyAMmEEmnuw9UI/..1s4B4eF/u9PzE2ZaGO.ij9YfmcUy.u',
          salt: null,
          wxOpenid: 'o_0FT0uyg_H1vVy2H0JpSwlVGhWQ',
          qqOpenid: null,
          createTime: '2018-04-20 07:15:18',
          updateTime: '2019-03-12 16:04:42',
          mail: '[e-mail]',
          delFlag: '0',
          lockFlag: '0',
          phone: '17034642888',
          avatar: 'lengleng-0d2a7b025da14d8d93f595b3fa082d82.jpg',
          deptId: 1,
          tenantId: 1,
          deptName: '真理部',
          roleList: [
            {
              roleId: 1,
              roleName: '管理员',
              roleCode: 'ROLE_ADMIN',
              roleDesc: '管理员',
              dsType: 2,
              dsScope: '2',
              createTime: '2017-10-29 15:45:51',
              updateTime: '2018-12-26 14:09:11',
              delFlag: '0',
            },
          ],
        },
	   ......
      ],
      total: 11,
      size: 10,
      current: 1,
      searchCount: true,
      pages: 1,
    },

###Department tree initialization data

returnReducedNode controls the data format of the department tree, true for simplified mode, false (default) for full data.

###Dynamically load the department tree

          loadData={({deptId, children})=>{
            return new Promise(resolve => {
              if (children) {
                resolve();
                return;
              }
              setTimeout(() => {
              // 通过 deptId 查询下层数据，返回后合并到树的数据源上
                resolve();
              }, 1000);
            });
          }}

####Lean mode If a node on the tree, its child nodes are all selected, the returned data only contains the parent node but not the child nodes

####Full mode If a node on the tree, its child nodes are all selected, the returned data will contain the parent node and child nodes

####Initialize the department tree If the initial data cannot contain the relationship between parent and child nodes, the department tree will appear out of sync when deleting with tag. Solution:

1. When saving data, please save the complete data, do not delete the content in children.

2. The use of reduced mode data may affect the background calculation.

Choose one of the above methods.

Development

$ git clone https://github.com/wafersystems/react-contacts.git
$ yarn
$ yarn start