@seres/vue2-lib

使用 vue2 作为主框架的系统公共组件

代码仓库地址：https://gitlab.seres.cn/lib/vue2-lib

文档地址：待开发

组件概览

• SlRichTextEditor：基于 ProseMirror 的富文本编辑器，支持表格合并、列表与撤销重做等能力。
• SlProvinceSelect：省份下拉选择器，内置省份数据。
• SlCitySelect：城市级联选择器，可与省份联动。
• SlDateRangePicker：日期区间选择器，封装 Element DatePicker。
• SlDangerTextButton：危险态文字按钮，解决 Element 文本按钮无法设置 danger 的问题。

使用

安装

npm i @seres/vue2-lib

全局引用

import Vue from 'vue';
import V2Lib from '@seres/vue2-lib';

// 全部样式
import '@seres/vue2-lib/lib/style/index.css';

Vue.use(V2Lib);

样式按需引用待开发，忽略 1、2 步骤 借助 babel-plugin-component 按需引用：

1. 安装依赖

npm install babel-plugin-component -D

2. 修改 .babelrc

{
  "presets": [
    [
      "@babel/preset-env",
      {
        "modules": false
      }
    ]
  ],
  "plugins": [
    [
      "component",
      {
        "libraryName": "@seres/vue2-lib",
        "styleLibraryName": "styles"
      }
    ]
  ]
}

3. 使用组件

<template>
  <SlProvinceSelect v-model="province" filterable clearable />
</template>

<script>
import { SlProvinceSelect } from '@seres/vue2-lib';
export default {
  components: { SlProvinceSelect },
  data() {
    return {
      value: '',
    };
  },
};
</script>

开发

目录结构

├── dev                       # 开发本地调试代码
│   ├── test-components       # 本地调试组件，在这里新增调试代码，App.vue中会自动引入并挂载（目录不会提交到git）
│   ├── App.vue               #
│   ├── index.html            #
│   ├── main.js               #
│   └── registerComponents.js # 自动注册调试代码逻辑
├── packages
│   ├── components            # 组件文件夹
│   └── styles                # 样式文件夹
├── scripts                   # 构建项目脚本
├── .gitignore                #
├── README.md                 #
├── package.json              #
└── yarn.lock                 #

开发流程

1. 在packages/components下新增以sl-组件名称作为组件目录
2. 在组件目录下新增index.js和需要的组件，并在index.js的完善自动注册并导出
3. 修改components下的index.js，注册并导出新的组件
4. 在dev/test-components下调试组件

发布

1. 本地构建

npm run build

2. 更新版本号

npm version [<newversion> | major | minor | patch | premajor | preminor | prepatch | prerelease]

1.0.0-0
| | | | - 测试版本号
| | | - 补丁版本
| | - 功能版本
| - 主版本

2. 推送

npm publish