xt-element-ui 2.0.0 → 2.0.2

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.
@@ -1,134 +1,134 @@
1
- ## XtProgress 进度条组件
2
-
3
- 进度条组件,用于展示任务完成进度。
4
-
5
- ## 基本用法
6
-
7
- ::: demo 基本用法
8
- ```vue
9
- <template>
10
- <XtProgress :percentage="60" />
11
- </template>
12
- ```
13
- :::
14
-
15
- ## 属性说明
16
-
17
- | 属性 | 类型 | 默认值 | 可选值 | 说明 |
18
- |------|------|--------|--------|------|
19
- | `percentage` | Number | `0` | 0-100 | 进度百分比 |
20
- | `type` | String | `line` | `line`、`circle`、`dashboard` | 进度条类型 |
21
- | `strokeWidth` | Number | `6` | - | 进度条宽度 |
22
- | `color` | String / Array | `#1890ff` | - | 进度条颜色 |
23
- | `status` | String | - | `success`、`exception`、`normal` | 状态 |
24
- | `width` | Number | `126` | - | 环形进度条宽度 |
25
- | `textInside` | Boolean | `false` | - | 是否将进度百分比显示在进度条内 |
26
- | `showText` | Boolean | `true` | - | 是否显示进度百分比 |
27
- | `format` | Function | - | - | 自定义进度条文字内容 |
28
-
29
- ## 示例
30
-
31
- ### 不同类型的进度条
32
-
33
- ::: demo 不同类型的进度条
34
- ```vue
35
- <template>
36
- <div style="display: flex; flex-direction: column; gap: 16px;">
37
- <XtProgress :percentage="60" />
38
- <XtProgress type="circle" :percentage="60" />
39
- <XtProgress type="dashboard" :percentage="60" />
40
- </div>
41
- </template>
42
- ```
43
- :::
44
-
45
- ### 不同状态
46
-
47
- ::: demo 不同状态
48
- ```vue
49
- <template>
50
- <div style="display: flex; flex-direction: column; gap: 16px;">
51
- <XtProgress :percentage="100" status="success" />
52
- <XtProgress :percentage="60" status="normal" />
53
- <XtProgress :percentage="60" status="exception" />
54
- </div>
55
- </template>
56
- ```
57
- :::
58
-
59
- ### 自定义颜色
60
-
61
- ::: demo 自定义颜色
62
- ```vue
63
- <template>
64
- <div style="display: flex; flex-direction: column; gap: 16px;">
65
- <XtProgress :percentage="60" color="#52c41a" />
66
- <XtProgress :percentage="60" color="#faad14" />
67
- <XtProgress :percentage="60" color="#f5222d" />
68
- </div>
69
- </template>
70
- ```
71
- :::
72
-
73
- ### 文字在进度条内
74
-
75
- ::: demo 文字在进度条内
76
- ```vue
77
- <template>
78
- <XtProgress :percentage="60" :text-inside="true" :stroke-width="20" />
79
- </template>
80
- ```
81
- :::
82
-
83
- ### 自定义宽度
84
-
85
- ::: demo 自定义宽度
86
- ```vue
87
- <template>
88
- <div style="display: flex; flex-direction: column; gap: 16px;">
89
- <XtProgress :percentage="60" :stroke-width="3" />
90
- <XtProgress :percentage="60" :stroke-width="6" />
91
- <XtProgress :percentage="60" :stroke-width="12" />
92
- </div>
93
- </template>
94
- ```
95
- :::
96
-
97
- ### 自定义文字格式
98
-
99
- ::: demo 自定义文字格式
100
- ```vue
101
- <template>
102
- <XtProgress :percentage="60" :format="(percent) => `${percent}% 完成`" />
103
- </template>
104
- ```
105
- :::
106
-
107
- ### 环形进度条
108
-
109
- ::: demo 环形进度条
110
- ```vue
111
- <template>
112
- <div style="display: flex; gap: 32px;">
113
- <XtProgress type="circle" :percentage="60" />
114
- <XtProgress type="circle" :percentage="60" :width="80" />
115
- <XtProgress type="circle" :percentage="60" :width="150" />
116
- </div>
117
- </template>
118
- ```
119
- :::
120
-
121
- ### 仪表盘
122
-
123
- ::: demo 仪表盘
124
- ```vue
125
- <template>
126
- <XtProgress type="dashboard" :percentage="60" />
127
- </template>
128
- ```
129
- :::
130
-
131
- ## 注意事项
132
-
133
- - `percentage` 属性值应在 0-100 之间
1
+ ## XtProgress 进度条组件
2
+
3
+ 进度条组件,用于展示任务完成进度。
4
+
5
+ ## 基本用法
6
+
7
+ ::: demo 基本用法
8
+ ```vue
9
+ <template>
10
+ <XtProgress :percentage="60" />
11
+ </template>
12
+ ```
13
+ :::
14
+
15
+ ## 属性说明
16
+
17
+ | 属性 | 类型 | 默认值 | 可选值 | 说明 |
18
+ |------|------|--------|--------|------|
19
+ | `percentage` | Number | `0` | 0-100 | 进度百分比 |
20
+ | `type` | String | `line` | `line`、`circle`、`dashboard` | 进度条类型 |
21
+ | `strokeWidth` | Number | `6` | - | 进度条宽度 |
22
+ | `color` | String / Array | `#1890ff` | - | 进度条颜色 |
23
+ | `status` | String | - | `success`、`exception`、`normal` | 状态 |
24
+ | `width` | Number | `126` | - | 环形进度条宽度 |
25
+ | `textInside` | Boolean | `false` | - | 是否将进度百分比显示在进度条内 |
26
+ | `showText` | Boolean | `true` | - | 是否显示进度百分比 |
27
+ | `format` | Function | - | - | 自定义进度条文字内容 |
28
+
29
+ ## 示例
30
+
31
+ ### 不同类型的进度条
32
+
33
+ ::: demo 不同类型的进度条
34
+ ```vue
35
+ <template>
36
+ <div style="display: flex; flex-direction: column; gap: 16px;">
37
+ <XtProgress :percentage="60" />
38
+ <XtProgress type="circle" :percentage="60" />
39
+ <XtProgress type="dashboard" :percentage="60" />
40
+ </div>
41
+ </template>
42
+ ```
43
+ :::
44
+
45
+ ### 不同状态
46
+
47
+ ::: demo 不同状态
48
+ ```vue
49
+ <template>
50
+ <div style="display: flex; flex-direction: column; gap: 16px;">
51
+ <XtProgress :percentage="100" status="success" />
52
+ <XtProgress :percentage="60" status="normal" />
53
+ <XtProgress :percentage="60" status="exception" />
54
+ </div>
55
+ </template>
56
+ ```
57
+ :::
58
+
59
+ ### 自定义颜色
60
+
61
+ ::: demo 自定义颜色
62
+ ```vue
63
+ <template>
64
+ <div style="display: flex; flex-direction: column; gap: 16px;">
65
+ <XtProgress :percentage="60" color="#52c41a" />
66
+ <XtProgress :percentage="60" color="#faad14" />
67
+ <XtProgress :percentage="60" color="#f5222d" />
68
+ </div>
69
+ </template>
70
+ ```
71
+ :::
72
+
73
+ ### 文字在进度条内
74
+
75
+ ::: demo 文字在进度条内
76
+ ```vue
77
+ <template>
78
+ <XtProgress :percentage="60" :text-inside="true" :stroke-width="20" />
79
+ </template>
80
+ ```
81
+ :::
82
+
83
+ ### 自定义宽度
84
+
85
+ ::: demo 自定义宽度
86
+ ```vue
87
+ <template>
88
+ <div style="display: flex; flex-direction: column; gap: 16px;">
89
+ <XtProgress :percentage="60" :stroke-width="3" />
90
+ <XtProgress :percentage="60" :stroke-width="6" />
91
+ <XtProgress :percentage="60" :stroke-width="12" />
92
+ </div>
93
+ </template>
94
+ ```
95
+ :::
96
+
97
+ ### 自定义文字格式
98
+
99
+ ::: demo 自定义文字格式
100
+ ```vue
101
+ <template>
102
+ <XtProgress :percentage="60" :format="(percent) => `${percent}% 完成`" />
103
+ </template>
104
+ ```
105
+ :::
106
+
107
+ ### 环形进度条
108
+
109
+ ::: demo 环形进度条
110
+ ```vue
111
+ <template>
112
+ <div style="display: flex; gap: 32px;">
113
+ <XtProgress type="circle" :percentage="60" />
114
+ <XtProgress type="circle" :percentage="60" :width="80" />
115
+ <XtProgress type="circle" :percentage="60" :width="150" />
116
+ </div>
117
+ </template>
118
+ ```
119
+ :::
120
+
121
+ ### 仪表盘
122
+
123
+ ::: demo 仪表盘
124
+ ```vue
125
+ <template>
126
+ <XtProgress type="dashboard" :percentage="60" />
127
+ </template>
128
+ ```
129
+ :::
130
+
131
+ ## 注意事项
132
+
133
+ - `percentage` 属性值应在 0-100 之间
134
134
  - 环形进度条默认宽度为 126px,可以通过 `width` 属性调整
@@ -1,141 +1,141 @@
1
- ## XtSelectTree 下拉选择树组件
2
-
3
- 下拉选择树组件,基于 ElementUI Tree 封装,支持单选、多选、懒加载等功能。
4
-
5
- ## 基本用法
6
-
7
- ::: demo 基本用法
8
- ```vue
9
- <template>
10
- <XtSelectTree v-model="selectedValue" :data="treeData" />
11
- </template>
12
-
13
- <script>
14
- export default {
15
- data() {
16
- return {
17
- selectedValue: '',
18
- treeData: [
19
- {
20
- label: '一级菜单',
21
- value: 1,
22
- children: [
23
- { label: '二级菜单1', value: 11 },
24
- { label: '二级菜单2', value: 12 }
25
- ]
26
- },
27
- { label: '二级菜单', value: 2 }
28
- ]
29
- }
30
- }
31
- }
32
- </script>
33
- ```
34
- :::
35
-
36
- ## 属性说明
37
-
38
- | 属性 | 类型 | 默认值 | 说明 |
39
- |------|------|--------|------|
40
- | `value` / `v-model` | String / Number / Array | - | 选中值,多选时为数组 |
41
- | `data` | Array | `[]` | 树数据 |
42
- | `props` | Object | `{ value: 'value', label: 'label', children: 'children' }` | 数据属性映射 |
43
- | `multiple` | Boolean | `false` | 是否多选 |
44
- | `filterable` | Boolean | `true` | 是否可搜索 |
45
- | `clearable` | Boolean | `false` | 是否可清空 |
46
- | `disabled` | Boolean | `false` | 是否禁用 |
47
- | `checkStrictly` | Boolean | `false` | 是否严格父子节点选择 |
48
- | `defaultExpandAll` | Boolean | `false` | 是否默认展开所有节点 |
49
- | `lazy` | Boolean | `false` | 是否懒加载 |
50
- | `load` | Function | - | 懒加载函数 |
51
- | `placement` | String | `bottom-start` | 弹出位置 |
52
- | `placeholder` | String | `请选择` | 占位提示 |
53
-
54
- ## 示例
55
-
56
- ### 多选模式
57
-
58
- ::: demo 多选模式
59
- ```vue
60
- <template>
61
- <XtSelectTree v-model="selectedValues" :data="treeData" multiple />
62
- </template>
63
-
64
- <script>
65
- export default {
66
- data() {
67
- return {
68
- selectedValues: [],
69
- treeData: [
70
- {
71
- label: '部门A',
72
- value: 1,
73
- children: [
74
- { label: '员工1', value: 11 },
75
- { label: '员工2', value: 12 }
76
- ]
77
- },
78
- { label: '部门B', value: 2 }
79
- ]
80
- }
81
- }
82
- }
83
- </script>
84
- ```
85
- :::
86
-
87
- ### 可搜索
88
-
89
- ::: demo 可搜索
90
- ```vue
91
- <template>
92
- <XtSelectTree v-model="selectedValue" :data="treeData" filterable />
93
- </template>
94
-
95
- <script>
96
- export default {
97
- data() {
98
- return {
99
- selectedValue: '',
100
- treeData: [
101
- { label: '张三', value: 1 },
102
- { label: '李四', value: 2 },
103
- { label: '王五', value: 3 }
104
- ]
105
- }
106
- }
107
- }
108
- </script>
109
- ```
110
- :::
111
-
112
- ### 可清空
113
-
114
- ::: demo 可清空
115
- ```vue
116
- <template>
117
- <XtSelectTree v-model="selectedValue" :data="treeData" clearable />
118
- </template>
119
-
120
- <script>
121
- export default {
122
- data() {
123
- return {
124
- selectedValue: '',
125
- treeData: [
126
- { label: '选项1', value: 1 },
127
- { label: '选项2', value: 2 }
128
- ]
129
- }
130
- }
131
- }
132
- </script>
133
- ```
134
- :::
135
-
136
- ## 事件
137
-
138
- | 事件名 | 说明 | 参数 |
139
- |--------|------|------|
140
- | `change` | 选中值改变时触发 | `value`, `node` |
1
+ ## XtSelectTree 下拉选择树组件
2
+
3
+ 下拉选择树组件,基于 ElementUI Tree 封装,支持单选、多选、懒加载等功能。
4
+
5
+ ## 基本用法
6
+
7
+ ::: demo 基本用法
8
+ ```vue
9
+ <template>
10
+ <XtSelectTree v-model="selectedValue" :data="treeData" />
11
+ </template>
12
+
13
+ <script>
14
+ export default {
15
+ data() {
16
+ return {
17
+ selectedValue: '',
18
+ treeData: [
19
+ {
20
+ label: '一级菜单',
21
+ value: 1,
22
+ children: [
23
+ { label: '二级菜单1', value: 11 },
24
+ { label: '二级菜单2', value: 12 }
25
+ ]
26
+ },
27
+ { label: '二级菜单', value: 2 }
28
+ ]
29
+ }
30
+ }
31
+ }
32
+ </script>
33
+ ```
34
+ :::
35
+
36
+ ## 属性说明
37
+
38
+ | 属性 | 类型 | 默认值 | 说明 |
39
+ |------|------|--------|------|
40
+ | `value` / `v-model` | String / Number / Array | - | 选中值,多选时为数组 |
41
+ | `data` | Array | `[]` | 树数据 |
42
+ | `props` | Object | `{ value: 'value', label: 'label', children: 'children' }` | 数据属性映射 |
43
+ | `multiple` | Boolean | `false` | 是否多选 |
44
+ | `filterable` | Boolean | `true` | 是否可搜索 |
45
+ | `clearable` | Boolean | `false` | 是否可清空 |
46
+ | `disabled` | Boolean | `false` | 是否禁用 |
47
+ | `checkStrictly` | Boolean | `false` | 是否严格父子节点选择 |
48
+ | `defaultExpandAll` | Boolean | `false` | 是否默认展开所有节点 |
49
+ | `lazy` | Boolean | `false` | 是否懒加载 |
50
+ | `load` | Function | - | 懒加载函数 |
51
+ | `placement` | String | `bottom-start` | 弹出位置 |
52
+ | `placeholder` | String | `请选择` | 占位提示 |
53
+
54
+ ## 示例
55
+
56
+ ### 多选模式
57
+
58
+ ::: demo 多选模式
59
+ ```vue
60
+ <template>
61
+ <XtSelectTree v-model="selectedValues" :data="treeData" multiple />
62
+ </template>
63
+
64
+ <script>
65
+ export default {
66
+ data() {
67
+ return {
68
+ selectedValues: [],
69
+ treeData: [
70
+ {
71
+ label: '部门A',
72
+ value: 1,
73
+ children: [
74
+ { label: '员工1', value: 11 },
75
+ { label: '员工2', value: 12 }
76
+ ]
77
+ },
78
+ { label: '部门B', value: 2 }
79
+ ]
80
+ }
81
+ }
82
+ }
83
+ </script>
84
+ ```
85
+ :::
86
+
87
+ ### 可搜索
88
+
89
+ ::: demo 可搜索
90
+ ```vue
91
+ <template>
92
+ <XtSelectTree v-model="selectedValue" :data="treeData" filterable />
93
+ </template>
94
+
95
+ <script>
96
+ export default {
97
+ data() {
98
+ return {
99
+ selectedValue: '',
100
+ treeData: [
101
+ { label: '张三', value: 1 },
102
+ { label: '李四', value: 2 },
103
+ { label: '王五', value: 3 }
104
+ ]
105
+ }
106
+ }
107
+ }
108
+ </script>
109
+ ```
110
+ :::
111
+
112
+ ### 可清空
113
+
114
+ ::: demo 可清空
115
+ ```vue
116
+ <template>
117
+ <XtSelectTree v-model="selectedValue" :data="treeData" clearable />
118
+ </template>
119
+
120
+ <script>
121
+ export default {
122
+ data() {
123
+ return {
124
+ selectedValue: '',
125
+ treeData: [
126
+ { label: '选项1', value: 1 },
127
+ { label: '选项2', value: 2 }
128
+ ]
129
+ }
130
+ }
131
+ }
132
+ </script>
133
+ ```
134
+ :::
135
+
136
+ ## 事件
137
+
138
+ | 事件名 | 说明 | 参数 |
139
+ |--------|------|------|
140
+ | `change` | 选中值改变时触发 | `value`, `node` |
141
141
  | `clear` | 清空时触发 | - |