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,84 +1,84 @@
1
- ## XtPage 页面组件
2
-
3
- 页面布局组件,提供 header、main、footer、aside 区域的布局,支持高度自适应。
4
-
5
- ## 基本用法
6
-
7
- ::: demo 基本用法
8
- ```vue
9
- <template>
10
- <XtPage>
11
- <template #header>页面标题</template>
12
- <template #default="{ tableHeight }">
13
- <XtTable :height="tableHeight" :table-data="tableData" :columns="columns" />
14
- </template>
15
- <template #footer>页面底部</template>
16
- </XtPage>
17
- </template>
18
-
19
- <script>
20
- export default {
21
- data() {
22
- return {
23
- tableData: [],
24
- columns: []
25
- }
26
- }
27
- }
28
- </script>
29
- ```
30
- :::
31
-
32
- ## 属性说明
33
-
34
- | 属性 | 类型 | 默认值 | 说明 |
35
- |------|------|--------|------|
36
- | `showHeader` | Boolean | `true` | 是否显示头部 |
37
- | `showFooter` | Boolean | `true` | 是否显示底部 |
38
- | `showAside` | Boolean | `true` | 是否显示侧边栏 |
39
- | `asideWidth` | String | - | 侧边栏宽度 |
40
- | `diffHeight` | Number | `60` | 差值高度 |
41
- | `minHeight` | Number | `200` | 最小高度 |
42
-
43
- ## 插槽说明
44
-
45
- | 插槽名 | 说明 |
46
- |--------|------|
47
- | `default` | 主内容区域,接收 `tableHeight` 参数 |
48
- | `header` | 头部区域 |
49
- | `footer` | 底部区域 |
50
- | `aside` | 侧边栏区域 |
51
- | `dialog` | 弹窗区域 |
52
-
53
- ## 示例
54
-
55
- ### 带侧边栏
56
-
57
- ::: demo 带侧边栏
58
- ```vue
59
- <template>
60
- <XtPage aside-width="200px">
61
- <template #header>页面标题</template>
62
- <template #aside>侧边栏内容</template>
63
- <template #default>主内容</template>
64
- </XtPage>
65
- </template>
66
- ```
67
- :::
68
-
69
- ### 仅主内容
70
-
71
- ::: demo 仅主内容
72
- ```vue
73
- <template>
74
- <XtPage :show-header="false" :show-footer="false">
75
- <template #default>仅主内容区域</template>
76
- </XtPage>
77
- </template>
78
- ```
79
- :::
80
-
81
- ## 注意事项
82
-
83
- - 默认插槽会传入 `tableHeight` 参数,用于表格高度自适应
1
+ ## XtPage 页面组件
2
+
3
+ 页面布局组件,提供 header、main、footer、aside 区域的布局,支持高度自适应。
4
+
5
+ ## 基本用法
6
+
7
+ ::: demo 基本用法
8
+ ```vue
9
+ <template>
10
+ <XtPage>
11
+ <template #header>页面标题</template>
12
+ <template #default="{ tableHeight }">
13
+ <XtTable :height="tableHeight" :table-data="tableData" :columns="columns" />
14
+ </template>
15
+ <template #footer>页面底部</template>
16
+ </XtPage>
17
+ </template>
18
+
19
+ <script>
20
+ export default {
21
+ data() {
22
+ return {
23
+ tableData: [],
24
+ columns: []
25
+ }
26
+ }
27
+ }
28
+ </script>
29
+ ```
30
+ :::
31
+
32
+ ## 属性说明
33
+
34
+ | 属性 | 类型 | 默认值 | 说明 |
35
+ |------|------|--------|------|
36
+ | `showHeader` | Boolean | `true` | 是否显示头部 |
37
+ | `showFooter` | Boolean | `true` | 是否显示底部 |
38
+ | `showAside` | Boolean | `true` | 是否显示侧边栏 |
39
+ | `asideWidth` | String | - | 侧边栏宽度 |
40
+ | `diffHeight` | Number | `60` | 差值高度 |
41
+ | `minHeight` | Number | `200` | 最小高度 |
42
+
43
+ ## 插槽说明
44
+
45
+ | 插槽名 | 说明 |
46
+ |--------|------|
47
+ | `default` | 主内容区域,接收 `tableHeight` 参数 |
48
+ | `header` | 头部区域 |
49
+ | `footer` | 底部区域 |
50
+ | `aside` | 侧边栏区域 |
51
+ | `dialog` | 弹窗区域 |
52
+
53
+ ## 示例
54
+
55
+ ### 带侧边栏
56
+
57
+ ::: demo 带侧边栏
58
+ ```vue
59
+ <template>
60
+ <XtPage aside-width="200px">
61
+ <template #header>页面标题</template>
62
+ <template #aside>侧边栏内容</template>
63
+ <template #default>主内容</template>
64
+ </XtPage>
65
+ </template>
66
+ ```
67
+ :::
68
+
69
+ ### 仅主内容
70
+
71
+ ::: demo 仅主内容
72
+ ```vue
73
+ <template>
74
+ <XtPage :show-header="false" :show-footer="false">
75
+ <template #default>仅主内容区域</template>
76
+ </XtPage>
77
+ </template>
78
+ ```
79
+ :::
80
+
81
+ ## 注意事项
82
+
83
+ - 默认插槽会传入 `tableHeight` 参数,用于表格高度自适应
84
84
  - 组件会监听窗口大小变化,自动调整表格高度
@@ -1,175 +1,175 @@
1
- ## XtPie 饼图组件
2
-
3
- 基于 ECharts 封装的饼图组件,支持环形图、玫瑰图、自定义颜色等功能。
4
-
5
- ## 基本用法
6
-
7
- ::: demo 基本用法
8
- ```vue
9
- <template>
10
- <XtPie :chart-data="chartData" />
11
- </template>
12
-
13
- <script>
14
- export default {
15
- data() {
16
- return {
17
- chartData: [
18
- { value: 53, label: "张三" },
19
- { value: 10, label: "李四" },
20
- { value: 60, label: "宋五" }
21
- ]
22
- }
23
- }
24
- }
25
- </script>
26
- ```
27
- :::
28
-
29
- ## 属性说明
30
-
31
- | 属性 | 类型 | 默认值 | 说明 |
32
- |------|------|--------|------|
33
- | `chartData` | Array | - | 图表数据,格式为 `[{ label, value }]` |
34
- | `fieldKeys` | Object | `{ label: "label", value: "value", data: "data" }` | 字段映射配置 |
35
- | `theme` | String | - | 主题,`dark` 或 `default` |
36
- | `size` | String | `medium` | 尺寸,`small` / `medium` / `large` |
37
- | `colors` | Array | `[]` | 自定义颜色数组 |
38
- | `unit` | String | `""` | 数据单位 |
39
- | `showLegend` | Boolean | `true` | 是否显示图例 |
40
- | `simpleMode` | Boolean | `false` | 是否启用极简模式 |
41
- | `roseType` | String | `""` | 玫瑰图类型,`""` / `radius` / `area` |
42
- | `showLabel` | Boolean | `true` | 是否显示标签 |
43
- | `totalLabel` | String | `"总数"` | 中心总数标签文本 |
44
-
45
- ## 示例
46
-
47
- ### 玫瑰图
48
-
49
- ::: demo 玫瑰图
50
- ```vue
51
- <template>
52
- <XtPie :chart-data="chartData" rose-type="radius" />
53
- </template>
54
-
55
- <script>
56
- export default {
57
- data() {
58
- return {
59
- chartData: [
60
- { value: 53, label: "北京" },
61
- { value: 60, label: "上海" },
62
- { value: 78, label: "广州" },
63
- { value: 82, label: "深圳" },
64
- { value: 95, label: "杭州" }
65
- ]
66
- }
67
- }
68
- }
69
- </script>
70
- ```
71
- :::
72
-
73
- ### 隐藏图例
74
-
75
- ::: demo 隐藏图例
76
- ```vue
77
- <template>
78
- <XtPie :chart-data="chartData" :show-legend="false" />
79
- </template>
80
-
81
- <script>
82
- export default {
83
- data() {
84
- return {
85
- chartData: [
86
- { value: 30, label: "A" },
87
- { value: 25, label: "B" },
88
- { value: 20, label: "C" },
89
- { value: 25, label: "D" }
90
- ]
91
- }
92
- }
93
- }
94
- </script>
95
- ```
96
- :::
97
-
98
- ### 自定义颜色
99
-
100
- ::: demo 自定义颜色
101
- ```vue
102
- <template>
103
- <XtPie :chart-data="chartData" :colors="['#1890ff', '#52c41a', '#faad14', '#f5222d']" />
104
- </template>
105
-
106
- <script>
107
- export default {
108
- data() {
109
- return {
110
- chartData: [
111
- { value: 30, label: "红色" },
112
- { value: 25, label: "蓝色" },
113
- { value: 20, label: "绿色" },
114
- { value: 25, label: "黄色" }
115
- ]
116
- }
117
- }
118
- }
119
- </script>
120
- ```
121
- :::
122
-
123
- ### 极简模式
124
-
125
- ::: demo 极简模式
126
- ```vue
127
- <template>
128
- <XtPie :chart-data="chartData" simple-mode />
129
- </template>
130
-
131
- <script>
132
- export default {
133
- data() {
134
- return {
135
- chartData: [
136
- { value: 30, label: "A" },
137
- { value: 25, label: "B" },
138
- { value: 20, label: "C" },
139
- { value: 25, label: "D" }
140
- ]
141
- }
142
- }
143
- }
144
- </script>
145
- ```
146
- :::
147
-
148
- ### 暗色主题
149
-
150
- ::: demo 暗色主题
151
- ```vue
152
- <template>
153
- <XtPie :chart-data="chartData" theme="dark" />
154
- </template>
155
-
156
- <script>
157
- export default {
158
- data() {
159
- return {
160
- chartData: [
161
- { value: 53, label: "张三" },
162
- { value: 60, label: "李四" },
163
- { value: 78, label: "王五" }
164
- ]
165
- }
166
- }
167
- }
168
- </script>
169
- ```
170
- :::
171
-
172
- ## 注意事项
173
-
174
- - 饼图中心会自动显示总数
1
+ ## XtPie 饼图组件
2
+
3
+ 基于 ECharts 封装的饼图组件,支持环形图、玫瑰图、自定义颜色等功能。
4
+
5
+ ## 基本用法
6
+
7
+ ::: demo 基本用法
8
+ ```vue
9
+ <template>
10
+ <XtPie :chart-data="chartData" />
11
+ </template>
12
+
13
+ <script>
14
+ export default {
15
+ data() {
16
+ return {
17
+ chartData: [
18
+ { value: 53, label: "张三" },
19
+ { value: 10, label: "李四" },
20
+ { value: 60, label: "宋五" }
21
+ ]
22
+ }
23
+ }
24
+ }
25
+ </script>
26
+ ```
27
+ :::
28
+
29
+ ## 属性说明
30
+
31
+ | 属性 | 类型 | 默认值 | 说明 |
32
+ |------|------|--------|------|
33
+ | `chartData` | Array | - | 图表数据,格式为 `[{ label, value }]` |
34
+ | `fieldKeys` | Object | `{ label: "label", value: "value", data: "data" }` | 字段映射配置 |
35
+ | `theme` | String | - | 主题,`dark` 或 `default` |
36
+ | `size` | String | `medium` | 尺寸,`small` / `medium` / `large` |
37
+ | `colors` | Array | `[]` | 自定义颜色数组 |
38
+ | `unit` | String | `""` | 数据单位 |
39
+ | `showLegend` | Boolean | `true` | 是否显示图例 |
40
+ | `simpleMode` | Boolean | `false` | 是否启用极简模式 |
41
+ | `roseType` | String | `""` | 玫瑰图类型,`""` / `radius` / `area` |
42
+ | `showLabel` | Boolean | `true` | 是否显示标签 |
43
+ | `totalLabel` | String | `"总数"` | 中心总数标签文本 |
44
+
45
+ ## 示例
46
+
47
+ ### 玫瑰图
48
+
49
+ ::: demo 玫瑰图
50
+ ```vue
51
+ <template>
52
+ <XtPie :chart-data="chartData" rose-type="radius" />
53
+ </template>
54
+
55
+ <script>
56
+ export default {
57
+ data() {
58
+ return {
59
+ chartData: [
60
+ { value: 53, label: "北京" },
61
+ { value: 60, label: "上海" },
62
+ { value: 78, label: "广州" },
63
+ { value: 82, label: "深圳" },
64
+ { value: 95, label: "杭州" }
65
+ ]
66
+ }
67
+ }
68
+ }
69
+ </script>
70
+ ```
71
+ :::
72
+
73
+ ### 隐藏图例
74
+
75
+ ::: demo 隐藏图例
76
+ ```vue
77
+ <template>
78
+ <XtPie :chart-data="chartData" :show-legend="false" />
79
+ </template>
80
+
81
+ <script>
82
+ export default {
83
+ data() {
84
+ return {
85
+ chartData: [
86
+ { value: 30, label: "A" },
87
+ { value: 25, label: "B" },
88
+ { value: 20, label: "C" },
89
+ { value: 25, label: "D" }
90
+ ]
91
+ }
92
+ }
93
+ }
94
+ </script>
95
+ ```
96
+ :::
97
+
98
+ ### 自定义颜色
99
+
100
+ ::: demo 自定义颜色
101
+ ```vue
102
+ <template>
103
+ <XtPie :chart-data="chartData" :colors="['#1890ff', '#52c41a', '#faad14', '#f5222d']" />
104
+ </template>
105
+
106
+ <script>
107
+ export default {
108
+ data() {
109
+ return {
110
+ chartData: [
111
+ { value: 30, label: "红色" },
112
+ { value: 25, label: "蓝色" },
113
+ { value: 20, label: "绿色" },
114
+ { value: 25, label: "黄色" }
115
+ ]
116
+ }
117
+ }
118
+ }
119
+ </script>
120
+ ```
121
+ :::
122
+
123
+ ### 极简模式
124
+
125
+ ::: demo 极简模式
126
+ ```vue
127
+ <template>
128
+ <XtPie :chart-data="chartData" simple-mode />
129
+ </template>
130
+
131
+ <script>
132
+ export default {
133
+ data() {
134
+ return {
135
+ chartData: [
136
+ { value: 30, label: "A" },
137
+ { value: 25, label: "B" },
138
+ { value: 20, label: "C" },
139
+ { value: 25, label: "D" }
140
+ ]
141
+ }
142
+ }
143
+ }
144
+ </script>
145
+ ```
146
+ :::
147
+
148
+ ### 暗色主题
149
+
150
+ ::: demo 暗色主题
151
+ ```vue
152
+ <template>
153
+ <XtPie :chart-data="chartData" theme="dark" />
154
+ </template>
155
+
156
+ <script>
157
+ export default {
158
+ data() {
159
+ return {
160
+ chartData: [
161
+ { value: 53, label: "张三" },
162
+ { value: 60, label: "李四" },
163
+ { value: 78, label: "王五" }
164
+ ]
165
+ }
166
+ }
167
+ }
168
+ </script>
169
+ ```
170
+ :::
171
+
172
+ ## 注意事项
173
+
174
+ - 饼图中心会自动显示总数
175
175
  - 最小扇区角度为 5 度,小于此角度的扇区会合并显示