工程说明

本工程为基于 vue-cli 的组件库构建、打包、发布及相关示例的前端工程。

本地开发环境

# 使用 npm 包管理器的

# 安装依赖
npm install

# 本地启动
npm run dev # 即可自动在浏览器中打开

# 使用 yarn 包管理器的

# 安装依赖
yarn install

# 本地启动，
yarn dev  # 即可自动在浏览器中打开

组件库构建与打包

组件开发完后，即可运行构建命令。

相关构建命令、发布命令在 package.json 中已配置，构建时，请确定好要构建的组件库版本号 "version": "xx.xx.xx",

{
  "version": "xx.xx.xx",
  "scripts": {
    "lib": "vue-cli-service build --target lib --name zcui --dest lib packages/index.js",
    "npm-l": "npm login",
    "npm-p": "npm publish --access=public"
  }
}

组件库构建

# 使用 npm 包管理器的
npm run lib

# 使用 yarn 包管理器的
yarn lib

构建成功后，确定各组件功能完好无误后，即可发布至 npm。

登录 npm

yarn npm-l

npm 发布包

yarn npm-p

发布成功后即可，安装使用该 npm 包了。

工程目录主要文件

│
├── examples                       // 组件库示例页面
├── lib                            // 组件库构建产物
├── package                        // 组件库源码
│
└── style                          // 样式文件
   ├── layout.scss                 // 布局样式
   ├── reset.scss                  // 重置样式
   ├── state.scss                  // 状态样式
   └── variables.scss              // 样式变量

组件库的使用

安装

# 使用 npm 包管理器的
npm install zc-framework-ui -S

# 使用 yarn 包管理器的
yarn add zc-framework-ui

卸载

# 使用 npm 包管理器的
npm uninstall zc-framework-ui

# 使用 yarn 包管理器的
yarn  remove zc-framework-ui

更新 ，再次安装即可更新至最新版本

# 使用 npm 包管理器的
npm install zc-framework-ui -S

# 使用 yarn 包管理器的
yarn add zc-framework-ui

工程中的使用

// 全局引用
import zcUI from 'zc-framework-ui';
import 'zc-framework-ui/lib/zcui.css';
Vue.use(zcUI);

<!-- 按需引入 -->
<script>
  import { List, Table, xxxxx } from 'zc-framework-ui';
  import 'zc-framework-ui/lib/zcui.css';

  export default {
    components: {
      ThemeList: List,
      ThemeTable: Table,
      xxxxx,
    },
  };
</script>

版本更新记录

1.1.18

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :----------------: | :------: | :--------: | | -- | -- | -修复若干已知 bug- | zkh、wmw | 2022/12/30 |

1.1.17

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :----------------: | :------: | :--------: | | -- | -- | -修复若干已知 bug- | zkh、wmw | 2022/12/29 |

1.1.16

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :--------------------------------------: | :--: | :--------: | | -- | -- | -修复组件上传后，下载功能中路径错误 bug- | wmw | 2022/12/19 |

1.1.15

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :-----------------------------------: | :--: | :--------: | | -- | -- | -修复地图选择器若干已知 bug 与优化项- | wmw | 2022/12/09 |

1.1.14

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :---------------------------------: | :--: | :--------: | | -- | -- | -修复系统设置若干已知 bug 与优化项- | wmw | 2022/12/08 |

1.1.13

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :-----------------: | :--: | :--------: | | -- | -- | -edit 组件增加类名- | wmw | 2022/12/07 |

1.1.12

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :------------------------------------------------: | :--: | :--------: | | -- | -- | -peoplePicker、orgPicker 组件增加自定义 className- | wmw | 2022/12/07 |

1.1.11

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :------------------------------------------------: | :--: | :--------: | | -- | -- | -五级区划组件最末级增加叶子节点标识- | wmw | 2022/12/02 | | -- | -- | -修复组织类型删除报错问题- | wmw | 2022/12/02 | | -- | -- | -修复菜单项新增后，无法选择刚新增的子项为上级菜单- | wmw | 2022/12/02 |

1.1.10

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------------------------------------ | :--- | :------: | :--: | :--------: | | -theme-orgPicker 支持隐藏头像与职位- | -- | -- | wmw | 2022/12/02 |

1.1.9

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | --------------------------------------- | :--- | :------: | :--: | :--------: | | -theme-peoplePicker 支持隐藏头像与职位- | -- | -- | wmw | 2022/12/02 |

1.1.8

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------------------------------- | :--- | :------: | :--: | :--------: | | -theme-peoplePicker 增加新特性- | -- | -- | wmw | 2022/12/02 |

1.1.7

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | -------------------------------------- | :--- | :------: | :--: | :--------: | | -theme-address 增加业务用户 code 参数- | -- | -- | wmw | 2022/12/01 |

1.1.6

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | -------------------------------------------------- | :--- | :------: | :--: | :--------: | | -theme-address 增加重置方法，增加了一些可选配置项- | -- | -- | wmw | 2022/11/30 |

1.1.5

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ---------------------------------- | :--- | :------: | :--: | :--------: | | -增加五级区划选择器 theme-address- | -- | -- | wmw | 2022/11/29 |

1.1.4

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :------------------------------: | :--: | :--------: | | -- | -- | -拓展 table 组件自定义 tag 显示- | wmw | 2022/11/26 |

1.1.3

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :-----------------------------: | :--: | :--------: | | -- | -- | -拓展 table 组件单元格点击参数- | wmw | 2022/11/25 |

1.1.2

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :------------------------------: | :--: | :--------: | | -- | -- | -解决表格组件操作栏字体显示 bug- | wmw | 2022/11/25 |

1.1.1

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ----------------------- | :--- | :------: | :--: | :--------: | | 发布 1.0 正式版本 1.1.1 | -- | -- | wmw | 2022/11/23 |

0.1.59

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ---------------------------------- | :--- | :------: | :--: | :--------: | | 菜单管理、角色管理增加平台类型配置 | -- | -- | wmw | 2022/11/23 |

0.1.58

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ---------------------------------------- | :--- | :------: | :--: | :--------: | | searchBar 组件增加 type 为 number 的支持 | -- | -- | wmw | 2022/11/18 |

0.1.57

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :-----------------: | :--: | :--------: | | -- | -- | 解决 table 报错问题 | wmw | 2022/11/17 |

0.1.56

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :--------------------------------------: | :--: | :--------: | | -- | -- | 解决用户管理，用户已存在时，无提示的问题 | wmw | 2022/11/17 |

0.1.55

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :------------------------------: | :--: | :--------: | | -- | -- | 解决 用户管理 点击编辑无响应问题 | wmw | 2022/11/15 | | -- | -- | 解决 table 自动高度计算问题 | wmw | 2022/11/15 |

0.1.54

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :------------------------------------------: | :--: | :--------: | | -- | -- | 解决 table 组件 操作菜单更多按钮字体过小问题 | wmw | 2022/11/14 |

0.1.53

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :------------------------------------------: | :--: | :--------: | | -- | -- | 解决 table 组件 操作菜单更多按钮字体过小问题 | wmw | 2022/11/14 |

0.1.52

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :---------------------------------: | :--: | :--------: | | -- | -- | 解决 table 组件字体大小不一致的 bug | wmw | 2022/11/14 |

0.1.51

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :--------------------------------: | :--: | :--------: | | -- | -- | 解决 tree 组件自定义 icon 样式问题 | wmw | 2022/11/11 |

0.1.50

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :---------------------------------------------: | :--: | :--------: | | -- | -- | 解决 tree 组件,自定义 props 中 label 不生效 bug | wmw | 2022/11/09 |

0.1.49

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :------------------------------------------: | :--: | :--------: | | -- | -- | 解决 table 组件，单元格字体调整并固定为 13px | wmw | 2022/11/08 |

0.1.48

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :---------------------------------------: | :--: | :--------: | | -- | -- | 解决 table 组件，height 传参 warning 问题 | wmw | 2022/11/08 | | -- | -- | 解决 uploadFile 组件，勾选项不能勾选问题 | wgx | 2022/11/08 |

0.1.47

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :------------------------------: | :--: | :--------: | | -- | -- | 解决 edit 组件，全屏模式样式问题 | wmw | 2022/11/04 |

0.1.46

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :----------------------------------------------------: | :--: | :--------: | | -- | -- | 解决 table 组件配置按钮多于 3 个时，前端异常报错的问题 | wmw | 2022/11/04 |

0.1.45

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :-----------------------------: | :--: | :--------: | | -- | -- | 解决 table 组件按钮不起作用效果 | wmw | 2022/11/03 |

0.1.39

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------------------------------------------------------- | :--- | :------: | :--: | :--------: | | edit 组件增加 mode、width、append-to-body 等 props 属性 | -- | -- | wmw | 2022/10/09 |

0.1.38

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :--------------------------: | :--: | :--------: | | -- | -- | 修复部门管理批量删除校验 bug | wmw | 2022/09/27 |

0.1.37

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ---------------------------- | :--- | :------: | :--: | :--------: | | 上传组件增加获取上传状态方法 | -- | -- | wmw | 2022/09/27 |

0.1.36

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :-----------------------: | :--: | :--------: | | -- | -- | 修复上传组件报错 404 问题 | wmw | 2022/09/26 |

0.1.35

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | -------------------------- | :--- | :------: | :--: | :--------: | | 去除组件 lib 中的 map 文件 | -- | -- | wmw | 2022/09/26 |

0.1.34

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ----------------------------------------------- | :--- | :------: | :--: | :--------: | | 上传组件 uploadFile 增加 isUploading 上传中标识 | -- | -- | wmw | 2022/09/26 |

0.1.33

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ---------------------- | :--- | :------: | :--: | :--------: | | table 增加 layout 配置 | -- | -- | wmw | 2022/09/02 |

0.1.32

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------------------------------ | :--- | :------: | :--: | :--------: | | orgPicker 组件增加数据监听逻辑 | -- | -- | wmw | 2022/08/26 |

0.1.31

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :--------------------------------: | :--: | :--------: | | -- | -- | table 组件前端分页参数改用监听逻辑 | wmw | 2022/08/24 |

0.1.30

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :-------------------------: | :--: | :--------: | | -- | -- | 修复 npm 打包后文件丢失 bug | wmw | 2022/08/23 |

0.1.29

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------------------------------ | :--- | :------: | :--: | :--------: | | table 表格操作按钮判断逻辑优化 | -- | -- | wmw | 2022/08/23 |

0.1.28

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------------------------------------------ | :--- | :------: | :--: | :--------: | | 树组件增加是否默认展开第一项配置 | -- | -- | wmw | 2022/08/23 | | table 表格增加自定义前端分页，前端分页数据 | -- | -- | wmw | 2022/08/23 |

0.1.27

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :--------------------: | :--: | :--------: | | -- | -- | 修复 tree 参数传递错误 | wmw | 2022/08/22 |

0.1.26

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------------------------------------------------- | :--- | :------: | :--: | :--------: | | 树组件，增加点击阻止冒泡，同时暴露 node 节点 data | -- | -- | wmw | 2022/08/22 |

0.1.25

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ----------------------------------- | :--- | :---------------------------------------: | :--: | :--------: | | -- | -- | 修复人员选择组件的$emit 事件未触发的 bug | wmw | 2022/08/18 | | 人员选择组件，增加 close 事件的调用 | -- | -- | wmw | 2022/08/19 |

0.1.24

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | -------------------------------------- | :--- | :---------------------------------------: | :--: | :--------: | | -- | -- | 修复人员选择组件的$emit 事件未触发的 bug | wmw | 2022/08/18 | | 人员选择组件，增加自定义插槽内容的支持 | -- | -- | wmw | 2022/08/18 |

0.1.23

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :----------------------------------------------------------: | :------: | :--------: | | -- | -- | 修复 file 上传 404 问题与$router 重复定义问题及其他已知问题 | wmw、wgx | 2022/08/17 |

0.1.22

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------------ | :--- | :------: | :------: | :--------: | | 修复已知问题 | -- | -- | wgx、wmw | 2022/08/12 |

0.1.21

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------------ | :--- | :------: | :--: | :--------: | | 增加模块打包 | -- | -- | wmw | 2022/08/12 | | 修复已知问题 | -- | -- | wmw | 2022/08/12 |

0.1.20

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :----------: | :--: | :--------: | | -- | -- | 解决已知问题 | wgx | 2022/08/09 |

0.1.19

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------------------------------------- | :--------------------- | :------: | :--: | :--------: | | edit 增加 header、footer 插槽的拓展 | -- | -- | wmw | 2022/08/08 | | detail 增加 header、footer 插槽的拓展 | -- | -- | wmw | 2022/08/08 | | table 增加 expand 插槽的拓展 | 可点击显示当前详情数据 | -- | wmw | 2022/08/08 |

0.1.18

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :----------: | :--: | :--------: | | -- | -- | 解决已知问题 | wgx | 2022/08/04 |

0.1.17

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :----------: | :--: | :--------: | | -- | -- | 解决已知问题 | wgx | 2022/08/04 |

0.1.16

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------------------------------------------------ | :--- | :------------------------------------------------------: | :--: | :--------: | | searchBar 增加配置子 slot 支持 | -- | | wmw | 2022/08/02 | | -- | -- | 修复 edit 弹窗组件，提交按钮防抖 bug, 暂时去除 mode 配置 | wmw | 2022/08/02 | | 增加地图拾取器组件 | -- | -- | wgx | 2022/08/02 | | 增加日期选择器（支持农历、节气，假日的显示） | -- | -- | wgx | 2022/08/02 | | 增加日期范围选择器（支持农历、节气，假日的显示） | -- | -- | wgx | 2022/08/02 | | 增加省市区三级联动组件 | -- | -- | wgx | 2022/08/02 |

0.1.15

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :----------: | :--: | :--------: | | -- | -- | 解决已知问题 | wmw | 2022/07/28 |

0.1.14

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--- | :----------: | :--: | :--------: | | -- | -- | 解决已知问题 | wmw | 2022/07/28 |

0.1.13

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ---------------------- | :------------------------------- | :------: | :--: | :--------: | | 增加组件按需引入的支持 | 可使用 import 的方式按需引入组件 | -- | wmw | 2022/07/20 |

0.1.12

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------------------------ | :-------------------------------- | :------: | :--: | :--------: | | 增加theme-calendar组件 | 日历组件，集成农历、24 节气的显示 | -- | wmw | 2022/07/20 |

0.1.11

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :----------- | :------: | :--: | :--------: | | -- | 完善说明文档 | -- | wmw | 2022/07/21 |

0.1.10

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :----------------------------------------------------------------------- | :----------------------: | :--: | :--------: | | -- | 完善 style 目录，增加 state.scss、layout.scss 等样式文件，可按需引入使用 | fix style @important err | wmw | 2022/07/20 |

0.1.9

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ------ | :--------------------------------------------------------------------------: | :----------------------: | :--: | :--------: | | -- | 完善 style 目录，包含 reset.scss、 variables.scss 等样式文件，可按需引入使用 | fix style @important err | wmw | 2022/07/20 |

0.1.8

| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 | | ---------------------------- | :----------: | :------: | :--: | :--------: | | 添加theme-list组件 | 列表组件 | -- | wmw | 2022/07/18 | | 添加theme-button组件 | 按钮组件 | -- | wmw | 2022/07/18 | | 添加theme-searchBar | 搜索组件 | -- | wmw | 2022/07/18 | | 添加theme-detail] | 详情组件 | -- | wmw | 2022/07/19 | | 添加theme-edit] | 编辑组件 | -- | wmw | 2022/07/19 | | 添加theme-table组件 | 表格组件 | -- | wmw | 2022/07/19 | | 添加theme-tree组件 | 树组件 | -- | wmw | 2022/07/19 | | 添加theme-pagination组件 | 分页组件 | -- | wmw | 2022/07/19 | | 添加theme-orgPicker组件 | 组织选择组件 | -- | wmw | 2022/07/19 | | 添加theme-peoplePicker组件 | 人员选择组件 | -- | wmw | 2022/07/19 | | 添加theme-orgPicker组件 | 表格组件 | -- | wmw | 2022/07/19 | | 添加theme-uploadFile组件 | 文件上传组件 | -- | wmw | 2022/07/19 | | 添加theme-previewFile组件 | 文件预览组件 | -- | wmw | 2022/07/19 |