通讯录选择，包含人员选择和分支选择

使用方式

import { createApp } from 'vue'
import ElementPlus from 'element-plus'
import 'element-plus/dist/index.css'
import AddressBookPicker from '@nmgolden/address-book-picker'
import '@nmgolden/address-book-picker/style.css'

const app = createApp(App)

app.use(ElementPlus)
app.use(AddressBookPicker, {
  baseUrl: '/api',
  timeout: 15000
})

组件库自身样式通过 @nmgolden/address-book-picker/style.css 提供。Element Plus 是组件库的 peer dependency，其组件和基础样式仍由宿主统一注册、引入。

组件内部使用 Axios 访问通讯录服务，默认请求超时时间为 15 秒，可通过 timeout 配置；传入 0 表示不设置超时。接口返回值既支持直接返回业务数据，也支持 { data: ... } 格式。

版本历史

1.3.2

发布时间：2026/08/05

• 修复-修正构建产物样式导出路径，宿主可通过 @nmgolden/address-book-picker/style.css 引入组件库样式

1.3.1

发布时间：2026/08/05

• 变更-优化人员和分支选择弹层的交互与展示
• 变更-完善 Axios 请求处理及组件依赖配置
• 变更-调整组件样式和相关功能实现

1.2.3

发布时间：2026/05/25

• 变更-人员列表批量选择入口调整为“选择当前列表”按钮，避免与持续勾选状态混淆

1.2.2

发布时间：2026/05/22

• 修复-人员列表滚动时人员 popover 延迟隐藏导致显示在容器外的问题
• 修复-UserBranchPicker 主弹层关闭后延迟隐藏的问题

1.2.1

发布时间：2026/05/19

• 变更-UserBranchPicker 弹层默认宽度增加到 720px，并支持通过 popoverWidth 配置
• 变更-人员列表数量显示调整为 已加载数量/总数 人

1.2.0

发布时间：2026/05/19

• 新增-人员手机号支持通过 maskMobile 配置是否脱敏展示，默认脱敏

1.1.2

发布时间：2025/11/20

• 新增-可多选人员
• 变更-人员分页每次加载 50 人

1.0.4

发布时间：2024/03/15

• 修复-下拉选择人员时人员 popover 在左上角闪烁的问题
• 修复-下拉选择分支单选时已选分支依然存在的问题
• 变更-下拉选择分支和人员时，关闭改为确定

1.0.3

发布时间：2024/02/29

• 修复-人员姓名过长导致出现横向滚动条而不能下拉加载更多数据的问题

1.0.2

发布时间：2024/02/19

• 变更-UserBranchPicker 高度更改

0.4.0

发布时间：2023/10/22

• 变更-更改接口地址

0.3.1

发布时间：2023/08/29

• 修改-user-branch-picker 组件在单选的情况下自动关闭选择弹窗

0.3.0

发布时间：2023/08/22

• 新增-支持配置 rootBranchIds 指定根分支

0.2.3

发布时间：2023/08/07

• 变更-css 变量统一增加了 "ab" 前缀，避免和宿主应用 css 变量冲突