address-book-shell 0.0.37 → 0.0.39

package/CHANGELOG.md

@@ -2,16 +2,28 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
-### 0.0.37 (202-01-15)
+### 0.0.39 (2026-01-15)
+
+* 新增 增加是否禁止选择领导功能([8819e551](https://gitlab.cjsc.com.cn/cjsc-backend/address-book/-/commit/8819e551103b78230ff44ead6424b21775c3d9bc))
+* 新增 群聊人员变动超过5人显示人员变动弹层([5d7730e8](https://gitlab.cjsc.com.cn/cjsc-backend/address-book/-/commit/5d7730e880f6be3b70758eb992a04a2e030ed2ef))
+* 新增 本地变动名单按钮及弹层([574fd322](https://gitlab.cjsc.com.cn/cjsc-backend/address-book/-/commit/574fd3220aea143f5d41dcbd881fae68549c7935))
+
+### 0.0.38 (2024-08-27)
+
+* bug修复([91634284](https://gitlab.cjsc.com.cn/cjsc-backend/address-book/-/commit/91634284333c772095e2f964ac46ca3cd686fbde))
+
+### 0.0.37 (2024-01-15)
+
 * 解决开启仅显示新增人员功能时,已选人数异常问题([c1f35729](https://gitlab.cjsc.com.cn/cjsc-backend/address-book/-/commit/c1f35729b73c9b02024927c156d00fc44ba3a0d8))
 
 ### 0.0.36 (2024-12-11)
+
 * 重复选人时给出提示([8f059456](https://gitlab.cjsc.com.cn/cjsc-backend/address-book/-/commit/8f0594566ae49dadd27cf3469662eb495ddb0798))
 * 新增showOnlyNewPersonnel配置,增加是否只展示新勾选人员功能([23790a1c](https://gitlab.cjsc.com.cn/cjsc-backend/address-book/-/commit/23790a1c77c81a96edc5a8eefec12c5bcd1c3a8c))
 * 搜索框自定义下拉框增加滚动监听事件([bcd0064b](https://gitlab.cjsc.com.cn/cjsc-backend/address-book/-/commit/bcd0064b3870aef2781433fd96dae555251b0391))
 
-
 ### 0.0.35 (2024-09-11)
+
 * 上传附件增加对wps非标准 MIME 类型支持([ddf8fccd](https://gitlab.cjsc.com.cn/cjsc-backend/address-book/-/commit/ddf8fccdf3a25461c2c645d2406ac8504f59a006))
 * 查询下拉框样式调整([f19991e8](https://gitlab.cjsc.com.cn/cjsc-backend/address-book/-/commit/f19991e8af0fb023fc3d868dedd20b54d812bf55))
 

package/README.md

@@ -1,4 +1,5 @@
-# address-book-shell 
+# address-book-shell
+
 基于vue2和element-ui开发的地址本组件
 
 > 目录
@@ -6,20 +7,21 @@
 [TOC]
 
 ### Install
+
 #### NPM
+
 ``` bash
 npm install address-book-shell --save
 ```
+
 #### Yarn
 
 ``` bash
 yarn add address-book-shell
 ```
 
-<br/> 或
-<br/>yarn add address-book-shell 
-
 ### 组件注册
+
 ```js
 import microserviceRequest from '@/utils/microService/microService-request.js'
 import AddressBookShell from 'address-book-shell'
@@ -28,11 +30,13 @@ Vue.use(AddressBookShell, {
   microserviceRequest: microserviceRequest,
 })
 ```
-上面的microserviceRequest是封装好的微服务请求方法,出于安全考虑,此方法不放在公网,因此需要业务方自行传入,否则无法使用本组件;
+
+microserviceRequest是封装好的微服务请求方法,出于安全考虑,此方法不放在公网,因此需要业务方自行传入,否则无法使用本组件;
 <br/>
 <br/>至此,地址本注册就完成了
 
 ### 组件使用
+
 需要使用地址本的项目要接入cas单点登录，然后注册地址本即可使用。
 
 ``` html
@@ -48,11 +52,14 @@ Vue.use(AddressBookShell, {
 ```
 
 ### 组件属性
+>
 > 注意:地址本组件继承了element-ui库Dialog组件的全部属性，即Dialog属性全部适用本组件。
 
 #### selected
+
  地址本需要默认勾选人员,可以通过selected将需要勾选的数据传入地址本;  
  数据格式如下:  
+
  ``` js
  selected: [
         {
@@ -84,27 +91,33 @@ Vue.use(AddressBookShell, {
   />
  
  ```
+
  以上列出的属性为必须属性，如添加了其他非必须属性，点击确定时也会原封不动暴露出去。
-    
- #### selectDisabled  
+
+#### selectDisabled  
+
  selected传入的默认选中状态是可以在地址本中取消选中的，如果不希望操作默认选中的数据，可配置selectDisabled属性，将默认传入的数据状态禁止操作。
+
   ```html
   <address-book-shell
     selectDisabled
   />
  ```
 
-  #### showOnlyNewPersonnel  
+#### showOnlyNewPersonnel  
+
  是否只展示新增的人员列表。
- 
+
 值为1，展示全部人员包括selected传进来的人员；值为2则只显示新增人员。不设置则默认取selectDisabled的值；
+
   ```html
   <address-book-shell
     :selectDisabled='2'
   />
  ```
 
- #### onlyOriginalData
+#### onlyOriginalData
+
  默认为false，此时地址本点确定按钮会调用接口,将岗位和部门转化为人员数据,并通过submitted方法返回给业务方。如果仅需要原始的勾选数据,则可以配置needPeopleData属性,直接返回数据避免调用接口，可以减少地址的本反应时间。
 
 > 注意,如果没有配置该属性,且勾选的只有人员数据,点击地址本确定按钮时也不会调用接口而是直接将人员数据直接返回。
@@ -115,25 +128,33 @@ Vue.use(AddressBookShell, {
   />
  ```
 
- #### typeList
+#### typeList
+
  地址本模糊搜索权限默认是根据用户身份自动配置的，但如果想自定义模糊搜索权限，则可以通过传入typeList来控制。
  例如仅开启人员权限
+
   ``` js
   typeList: ['人员'] 
   <address-book-shell
     :typeList='typeList'
   />
  ```
+
 #### onlyMailList
+
 地址本默认会根据身份自动加载对应模块,内部员默认加载通讯录和合作方好友模块,如果内部员工只想加载通讯录模块,可以设置onlyMailList属性快速设置
+
   ```html
   <address-book-shell
     onlyMailList
   />
  ```
+
 #### tabs
+
 与onlyMailList一样都是用来控制地址本加载模块的。如果想自定义加载的模块,可手动配置tabs参数来实现。  
 例如：
+
   ``` js
   tabs: ['通讯录', '合作方好友'] 
   <address-book-shell
@@ -141,17 +162,22 @@ Vue.use(AddressBookShell, {
   />
  ```
 
- #### radio
+#### radio
+
  地址本是否开启单选模式
+
    ```html
   <address-book-shell
     radio
   />
  ```
+
 >注意：如果开启了单选模式，selected传入的数据又不止一个的话，地址本只会获取第一项数据，其他数据将被抛弃。
 
 #### title
+
 地址本组件的标题，默认为'地址本'。
+
    ```html
   <address-book-shell
     title='测试地址本'
@@ -159,25 +185,29 @@ Vue.use(AddressBookShell, {
   ```
 
 #### width
+
 地址本弹层的宽度，默认为'800px'
+
  ```html
   <address-book-shell
     width='800px'
   />
   ```
 
-
 #### customClass
+
 自定义地址本的class类名，默认为address-modal,设置自定义类型即可定制一些样式。
+
  ```html
   <address-book-shell
     customClass='demo-address'
   />
   ```
 
-
 #### noAddRecent
+
 是否不需要添加最近联系人,设置改属性之后点击确定按钮不会将已选人写入最近联系人
+
  ```html
   <address-book-shell
     noAddRecent
@@ -185,7 +215,9 @@ Vue.use(AddressBookShell, {
   ```
 
 #### hiddenRecently
+
 隐藏最近联系人模块,设置改属性之后,地址本上将不在显示地址本模块
+
  ```html
   <address-book-shell
     hiddenRecently
@@ -193,22 +225,31 @@ Vue.use(AddressBookShell, {
   ```
 
 #### footButton
+
 自定义左下角功能按钮,目前可以控制两个按钮,查看当前名单和收藏当前名单(未开发完成),其中查看当前名单会动态显影,即只有选择了部门或岗位才回显,仅选择了人员该按钮不会显示.
+
  ```html
   <address-book-shell
     :footButton="['check']"
   />
   ```
 
+>注意：配置了change并不会一定显示“本次变动名单”按钮，selected必须有值才会显示。
+
 #### top
+
 自定义地址本组件margin-top值,默认为'7vh'
+
  ```html
   <address-book-shell
     top='7vh'
   />
   ```
+
 #### robotsList
+
 机器人数据,不传或传[],不会显示机器人模块
+
   ``` js
   robotsList: [
     {
@@ -233,8 +274,10 @@ Vue.use(AddressBookShell, {
   />
  ```
 
- #### loginUserinfo
+#### loginUserinfo
+
  cas单点登录会回来的用户信息,毕传,否则地址本将无法正常使用.
+
   ``` js
   loginUserinfo: {
     dept: "公司领导",
@@ -254,8 +297,10 @@ Vue.use(AddressBookShell, {
   />
  ```
 
- #### searchStatus
+#### searchStatus
+
  控制模糊搜索的权限,'1'：搜索全部; '2'：仅内部; '3'：仅合作方。如果没有手动配置,地址本会根据使用场景自动分配权限：长江e家默认'1',web默认'2'
+
   ```html
   <address-book-shell
     searchStatus='1'
@@ -263,18 +308,31 @@ Vue.use(AddressBookShell, {
   ```
 
 #### defaultActiveMenu
+
 自定义初始化时菜单默认选中项,值为部门id,即deptId。(例如: 'C1','D794')
+
   ```html
   <address-book-shell
     defaultActiveMenu='C1'
   />
   ```
 
+#### enableChangeConfirmation
+
+是否开启 人员变动超过5人，确定时弹窗提示功能
+
+  ```html
+  <address-book-shell
+    enableChangeConfirmation
+  />
+  ```
 
+>注意：配置了enableChangeConfirmation并不会一定显示人员变动弹层，selected必须有值才会显示。
 
 ### 属性总览
+
 |  参数   |      说明  | 类型 | 可选值 | 默认值 |
-| :---   | :--- | :--- | :---: |:---:    | 
+| :---   | :--- | :--- | :---: |:---:    |
 | selected   | 地址本初始化默认选中的人员数据  | Array  | - |  []    |
 | selectDisabled  | 是否将selected传入的人员置灰不能再选 | Boolean | - | false  |
 | showOnlyNewPersonnel  | 是否只展示新勾选的人员，默认值为0，取selectDisabled的值；值为1，展示全部人员；值为2，只展示新勾选的人员 | Number | 0,1,2 | 0 |
@@ -288,20 +346,20 @@ Vue.use(AddressBookShell, {
 | customClass  | 地址本自定义类名 | String | - | address-modal  |
 | noAddRecent  | 是否不需要添加最近联系人 | Boolean | - | false  |
 | hiddenRecently  | 是否隐藏最近联系人模块 | Boolean | - | false  |
-| footButton  | 自定义功能按钮(check:查看当前名单;collect: 收藏当前名单) | Array | ['check','collect'] |  ['check'] |
+| footButton  | 自定义功能按钮(check:查看当前名单;collect: 收藏当前名单;change: 本次变动名单) | Array | ['check','collect','change'] |  ['check'] |
 | top  | 地址本 CSS 中的 margin-topz值 | string | - | 7vh  |
 | robotsList  | 机器人数据,不传或传[],不会显示机器人模块 | Array | - | []  |
 | loginUserinfo  | cas登录返回的用户信息(必传) | Object | - | {}  |
 | searchStatus   | 搜索框权限控制  | String | '1':搜索全部;'2':仅内部;'3':仅合作方 | 长江e家默认'1',web默认'2'  |
 | defaultActiveMenu  | 菜单默认选中项 | String | - |   |
-
-
-
+| enableChangeConfirmation  | 拉人超过5人 弹窗提示 | Boolean | - | false  |
 
 ### 组件事件
+>
 > 注意:地址本组件继承了element-ui库Dialog组件的全部事件，即Dialog事件全部适用本组件。
 
 #### submitted
+
 点击地址本确定按钮的回调事件,将根据是否配置onlyOriginalData属性返回不同的值
 
 ``` html
@@ -326,8 +384,11 @@ Vue.use(AddressBookShell, {
     console.log('默认勾选的所有数据数据,包含勾选的人员、部门和岗位')
   }
 ```
+
 #### add
+
 地址本勾选时触发,返回两个参数,类型全部为数组,第一个参数为新勾选的数据;第二参数为勾选的全部数据
+
 ``` html
  <address-book-shell
     @add='add'
@@ -337,8 +398,11 @@ Vue.use(AddressBookShell, {
     console.log('勾选的全部数据',selectList)
   }
 ```
+
 #### remove
+
 地址本取消勾选时触发,返回两个参数,类型全部为数组,第一个参数为取消勾选的数据;第二参数为勾选的全部数据
+
 ``` html
  <address-book-shell
     @remove='remove'
@@ -350,12 +414,21 @@ Vue.use(AddressBookShell, {
 ```
 
 ### 事件总览
+
 组件自定义事件:
+
 |  事件名称   | 说明   | 回调参数 |
 | :---  | :---  | :-- |
 | submitted  | 点击确实按钮的回调 | [全部人员数据],[仅结构数据],[原始勾选数据]  或 [原始勾选数据]|
 |    add     | 新增勾选的回调     |     [新增勾选数据],[勾选的全部数据]                        |
 |    remove  | 取消勾选的回调     |     [取消勾选数据],[勾选的全部数据]                        |
 
+### 内置功能
+
+#### 名单导入
+
+>名单导入通过调用接口查询权限开启，开启之后，可通过上传指定格式的excel表单选择人员。
 
+#### 禁选领导
 
+>0.0.39版本增加勾选**总部公司领导**功能，该功能会调用接口查询权限，无权限无法勾选 **总部公司领导具体每个人员、公司领导部门、公司领导下的岗位。**