n20-project-component 1.0.1 → 1.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.en.md ADDED
@@ -0,0 +1,36 @@
1
+ # k13-07_G6公共产品包前端
2
+
3
+ #### Description
4
+ G6公共产品包前端代码
5
+
6
+ #### Software Architecture
7
+ Software architecture description
8
+
9
+ #### Installation
10
+
11
+ 1. xxxx
12
+ 2. xxxx
13
+ 3. xxxx
14
+
15
+ #### Instructions
16
+
17
+ 1. xxxx
18
+ 2. xxxx
19
+ 3. xxxx
20
+
21
+ #### Contribution
22
+
23
+ 1. Fork the repository
24
+ 2. Create Feat_xxx branch
25
+ 3. Commit your code
26
+ 4. Create Pull Request
27
+
28
+
29
+ #### Gitee Feature
30
+
31
+ 1. You can use Readme\_XXX.md to support different languages, such as Readme\_en.md, Readme\_zh.md
32
+ 2. Gitee blog [blog.gitee.com](https://blog.gitee.com)
33
+ 3. Explore open source project [https://gitee.com/explore](https://gitee.com/explore)
34
+ 4. The most valuable open source project [GVP](https://gitee.com/gvp)
35
+ 5. The manual of Gitee [https://gitee.com/help](https://gitee.com/help)
36
+ 6. The most popular members [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)
package/README.md CHANGED
@@ -1,179 +1,111 @@
1
- # n20-project-component
2
-
3
- PC 端 Vue 2 + Element UI 通用组件库,公司内部项目复用。
4
-
5
- ## 组件列表
6
-
7
- | 组件 | 说明 | 状态 |
8
- |------|------|------|
9
- | N20CopyText | 点击复制文本,弹出「已复制」反馈 | 已完成 |
10
- | N20FloatingToolbar | 选中文字后浮现操作工具条 | 🔲 待开发 |
11
- | N20Marquee | 滚动通知条(水平/垂直) | 🔲 待开发 |
12
- | N20FrequentWords | 常用词输入,自动记录到本地缓存 | 🔲 待开发 |
13
- | N20BatchInput | 批量输入,粘贴自动拆分为多个标签 | 🔲 待开发 |
14
-
15
- ---
16
-
17
- ## 发布
18
-
19
- ### 前置条件
20
-
21
- - Node 14+
22
- - npm 账号([注册地址](https://www.npmjs.com/signup))
23
- - npm 账号需开启 2FA 或创建 Granular Access Token
24
-
25
- ### 构建
26
-
27
- ```bash
28
- npm run build
29
- ```
30
-
31
- 构建产物在 `dist/` 目录下:
32
-
33
- ```
34
- dist/
35
- ├── n20-project-component.umd.min.js # UMD 压缩版
36
- ├── n20-project-component.umd.js # UMD 开发版
37
- ├── n20-project-component.common.js # CommonJS
38
- └── n20-project-component.css # 样式文件
39
- ```
40
-
41
- ### 发布到 npm
42
-
43
- ```bash
44
- # 首次使用先登录
45
- npm login
46
-
47
- # 发布(需要 2FA 验证码)
48
- npm publish --otp=你的6位验证码
49
- ```
50
-
51
- 如果用 Access Token 方式发布:
52
-
53
- ```bash
54
- npm publish --access public --//registry.npmjs.org/:_authToken=你的token
55
- ```
56
-
57
- ### 更新版本
58
-
59
- ```bash
60
- # 补丁版本 1.0.0 → 1.0.1
61
- npm version patch
62
-
63
- # 次版本 1.0.0 1.1.0
64
- npm version minor
65
-
66
- # 主版本 1.0.0 → 2.0.0
67
- npm version major
68
-
69
- # 然后发布
70
- npm publish --otp=验证码
71
- ```
72
-
73
- ---
74
-
75
- ## 安装
76
-
77
- ```bash
78
- npm install n20-project-component
79
- ```
80
-
81
- ---
82
-
83
- ## 使用
84
-
85
- ### 全量引入
86
-
87
- 在 `main.js` 中:
88
-
89
- ```javascript
90
- import Vue from 'vue'
91
- import N20Components from 'n20-project-component'
92
- import 'n20-project-component/dist/n20-project-component.css'
93
-
94
- Vue.use(N20Components)
95
- ```
96
-
97
- 之后在任意 `.vue` 文件中直接使用:
98
-
99
- ```vue
100
- <N20CopyText text="BILL-2024-001">BILL-2024-001</N20CopyText>
101
- ```
102
-
103
- ### 按需引入
104
-
105
- ```javascript
106
- import { N20CopyText } from 'n20-project-component'
107
- import 'n20-project-component/dist/n20-project-component.css'
108
-
109
- // 全局注册
110
- Vue.component('N20CopyText', N20CopyText)
111
-
112
- // 或在组件内局部注册
113
- export default {
114
- components: { N20CopyText }
115
- }
116
- ```
117
-
118
- ---
119
-
120
- ## 组件文档
121
-
122
- ### N20CopyText
123
-
124
- 点击复制文本到剪贴板,显示「已复制」反馈气泡。
125
-
126
- #### 基础用法
127
-
128
- ```vue
129
- <N20CopyText text="需要复制的内容">显示的文字</N20CopyText>
130
- ```
131
-
132
- #### 在表格中使用
133
-
134
- ```vue
135
- <el-table-column label="单据编号">
136
- <template slot-scope="{ row }">
137
- <N20CopyText :text="row.billNo">{{ row.billNo }}</N20CopyText>
138
- </template>
139
- </el-table-column>
140
- ```
141
-
142
- #### Props
143
-
144
- | 参数 | 说明 | 类型 | 默认值 |
145
- |------|------|------|--------|
146
- | text | 要复制的文本,留空则取 slot 内容 | String / Number | '' |
147
- | successTip | 复制成功提示 | String | '已复制' |
148
- | showIcon | 是否显示复制图标 | Boolean | true |
149
- | iconPosition | 图标位置 left / right | String | 'right' |
150
- | disabled | 是否禁用 | Boolean | false |
151
-
152
- #### Events
153
-
154
- | 事件名 | 说明 | 参数 |
155
- |--------|------|------|
156
- | copy | 复制成功 | (text) |
157
- | error | 复制失败 | (error) |
158
-
159
- ---
160
-
161
- ## 本地开发
162
-
163
- ```bash
164
- # 安装依赖
165
- npm install
166
-
167
- # 启动开发调试(examples 目录)
168
- npm run dev
169
-
170
- # 构建
171
- npm run build
172
- ```
173
-
174
- 新增组件步骤:
175
-
176
- 1. 在 `src/components/` 下创建组件目录和 `index.vue`
177
- 2. 在 `src/index.js` 中导入并注册
178
- 3. 在 `examples/App.vue` 中添加使用示例
179
- 4. `npm run dev` 调试验证
1
+ # n20-project-component
2
+
3
+ PC 端 Vue 2 + Element UI 通用组件库,用于公司内部项目复用。
4
+
5
+ ## 组件列表
6
+
7
+ | 组件 | 说明 | 状态 |
8
+ |------|------|------|
9
+ | N20CopyText | 点击复制文本,弹出已复制反馈 | 已完成 |
10
+ | N20FloatingToolbar | 选中文字后浮现操作工具条 | 已完成 |
11
+ | N20BatchInput | 批量输入,粘贴自动拆分并写回逗号分隔字符串 | 已完成 |
12
+ | N20FrequentWords | 常用词输入,自动记录到本地缓存 | 待开发 |
13
+
14
+ ## 安装
15
+
16
+ ```bash
17
+ npm install n20-project-component
18
+ ```
19
+
20
+ ## 使用
21
+
22
+ ### 全量引入
23
+
24
+ 在 `main.js` 中:
25
+
26
+ ```javascript
27
+ import Vue from 'vue'
28
+ import N20Components from 'n20-project-component'
29
+ import 'n20-project-component/dist/n20-project-component.css'
30
+
31
+ Vue.use(N20Components)
32
+ ```
33
+
34
+ ### 按需引入
35
+
36
+ ```javascript
37
+ import Vue from 'vue'
38
+ import {
39
+ N20CopyText,
40
+ N20FloatingToolbar,
41
+ N20BatchInput,
42
+ } from 'n20-project-component'
43
+ import 'n20-project-component/dist/n20-project-component.css'
44
+
45
+ Vue.component('N20CopyText', N20CopyText)
46
+ Vue.component('N20FloatingToolbar', N20FloatingToolbar)
47
+ Vue.component('N20BatchInput', N20BatchInput)
48
+ ```
49
+
50
+ ## 组件示例
51
+
52
+ ### N20CopyText
53
+
54
+ ```vue
55
+ <N20CopyText text="BILL-2024-001">BILL-2024-001</N20CopyText>
56
+ ```
57
+
58
+ ### N20FloatingToolbar
59
+
60
+ ```vue
61
+ <N20FloatingToolbar
62
+ :actions="[
63
+ { label: '复制', command: 'copy' },
64
+ { label: '搜索', command: 'search' }
65
+ ]"
66
+ @action="handleToolbarAction"
67
+ >
68
+ <div>这里是可选中文本区域</div>
69
+ </N20FloatingToolbar>
70
+ ```
71
+
72
+ ### N20BatchInput
73
+
74
+ ```vue
75
+ <N20BatchInput
76
+ v-model="batchValue"
77
+ :max="100"
78
+ placeholder="点击输入批量数据"
79
+ />
80
+ ```
81
+
82
+ 说明:
83
+ - 触发方式为输入框右侧编辑图标或点击输入框。
84
+ - 支持从 Excel 粘贴,按换行、Tab、英文逗号、中文逗号拆分。
85
+ - 超出最大条数时禁止确认。
86
+ - 确认后通过 `v-model` 回写逗号分隔字符串。
87
+
88
+ ## 本地开发
89
+
90
+ ```bash
91
+ # 安装依赖
92
+ npm install
93
+
94
+ # 启动示例调试
95
+ npm run dev
96
+
97
+ # 构建组件库
98
+ npm run build
99
+ ```
100
+
101
+ ## 构建产物
102
+
103
+ 构建后产物位于 `dist/`:
104
+
105
+ ```text
106
+ dist/
107
+ ├── n20-project-component.umd.min.js
108
+ ├── n20-project-component.umd.js
109
+ ├── n20-project-component.common.js
110
+ └── n20-project-component.css
111
+ ```
@@ -0,0 +1,8 @@
1
+ <?xml version="1.0" encoding="UTF-8"?>
2
+ <svg width="20px" height="20px" viewBox="0 0 20 20" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
3
+ <title>页面</title>
4
+ <g id="页面" stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
5
+ <rect id="矩形" fill="#000000" fill-rule="nonzero" opacity="0" x="0" y="0" width="20" height="20"></rect>
6
+ <path d="M16.6914062,5.63867188 C16.8085938,5.75585938 16.875,5.9140625 16.875,6.08007812 L16.875,18.125 C16.875,18.4707031 16.5957031,18.75 16.25,18.75 L3.75,18.75 C3.40429688,18.75 3.125,18.4707031 3.125,18.125 L3.125,1.875 C3.125,1.52929688 3.40429688,1.25 3.75,1.25 L12.0449219,1.25 C12.2109375,1.25 12.3710938,1.31640625 12.4882813,1.43359375 L16.6914062,5.63867188 Z M15.4335938,6.3671875 L11.7578125,2.69140625 L11.7578125,6.3671875 L15.4335938,6.3671875 Z M6.25,9.4140625 C6.16370551,9.4140625 6.09375,9.48401801 6.09375,9.5703125 L6.09375,10.5078125 C6.09375,10.594107 6.16370551,10.6640625 6.25,10.6640625 L13.75,10.6640625 C13.8362945,10.6640625 13.90625,10.594107 13.90625,10.5078125 L13.90625,9.5703125 C13.90625,9.48401801 13.8362945,9.4140625 13.75,9.4140625 L6.25,9.4140625 Z M6.25,12.0703125 C6.16370551,12.0703125 6.09375,12.140268 6.09375,12.2265625 L6.09375,13.1640625 C6.09375,13.250357 6.16370551,13.3203125 6.25,13.3203125 L9.84375,13.3203125 C9.93004449,13.3203125 10,13.250357 10,13.1640625 L10,12.2265625 C10,12.140268 9.93004449,12.0703125 9.84375,12.0703125 L6.25,12.0703125 Z" id="形状" fill="#1677FF" fill-rule="nonzero"></path>
7
+ </g>
8
+ </svg>
@@ -0,0 +1,9 @@
1
+ <?xml version="1.0" encoding="UTF-8"?>
2
+ <svg width="20px" height="20px" viewBox="0 0 20 20" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
3
+ <title>文件</title>
4
+ <g id="文件" stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
5
+ <rect id="矩形" fill="#000000" fill-rule="nonzero" opacity="0" x="0" y="0" width="20" height="20"></rect>
6
+ <rect id="矩形" fill="#FFBF00" opacity="0.300000012" x="3" y="4" width="14" height="11"></rect>
7
+ <path d="M17.1875,5.828125 L10.1757812,5.828125 L7.88476562,3.63671875 C7.85546875,3.609375 7.81640625,3.59375 7.77734375,3.59375 L2.8125,3.59375 C2.46679688,3.59375 2.1875,3.87304688 2.1875,4.21875 L2.1875,15.78125 C2.1875,16.1269531 2.46679688,16.40625 2.8125,16.40625 L17.1875,16.40625 C17.5332031,16.40625 17.8125,16.1269531 17.8125,15.78125 L17.8125,6.453125 C17.8125,6.10742188 17.5332031,5.828125 17.1875,5.828125 Z" id="路径" fill="#FFBF00" fill-rule="nonzero"></path>
8
+ </g>
9
+ </svg>
@@ -0,0 +1,3 @@
1
+ <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
2
+ <path d="M8.66626 7.33398H14.6663V8.66699H8.66626V14.667H7.33325V8.66699H1.33325V7.33398H7.33325V1.33398H8.66626V7.33398Z" fill="#4E5969"/>
3
+ </svg>