@easyv/screen-cli 0.1.3 → 0.1.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.md +31 -7
- package/dist/commands/elements.js +226 -0
- package/dist/index.js +2 -0
- package/package.json +1 -1
- package/skills/easyv-component-dev/SKILL.md +5 -3
- package/skills/easyv-screen-build/SKILL.md +7 -24
- package/skills/easyv-screen-data/SKILL.md +17 -7
- package/skills/easyv-screen-debug/SKILL.md +8 -4
- package/skills/easyv-screen-edit/SKILL.md +20 -10
- package/skills/easyv-screen-shared/SKILL.md +23 -2
- package/skills/{easyv-screen-build → easyv-screen-shared}/references/component-selection.md +15 -1
- package/skills/easyv-screen-shared/references/custom-events.md +133 -0
- package/skills/easyv-screen-shared/references/panels-containers.md +114 -0
- package/skills/figma-asset-slice/SKILL.md +194 -0
- package/skills/figma-asset-slice/scripts/build_preview.py +446 -0
- package/spec/openapi.v1.yaml +829 -83
package/README.md
CHANGED
|
@@ -158,7 +158,11 @@ easyv-screen screen document put <id> -f doc.json --if-match <revision>
|
|
|
158
158
|
|
|
159
159
|
| 操作 | 作用 |
|
|
160
160
|
| --- | --- |
|
|
161
|
-
| `addComponent` | 新增组件。`key`、`module`、`version`、`name`、`layout`;可选 `configPatches`、`data`、`parentKey`、`index` |
|
|
161
|
+
| `addComponent` | 新增组件。`key`、`module`、`version`、`name`、`layout`;可选 `configPatches`、`data`、`parentKey`、`index`。`parentKey` 只能是已有分组 |
|
|
162
|
+
| `addPanel` | 新增动态面板,自带一个空状态。`key`、可选 `name`、`layout`、`parentKey`、`index` |
|
|
163
|
+
| `addContainer` | 新增组件容器,自带一个空子屏。字段同 `addPanel`,名称最长 50 |
|
|
164
|
+
| `addFilter` | 在根屏上新增过滤器。`key`、`name`,可选 `content`、`callbackKeys` |
|
|
165
|
+
| `addDataContainer` | 在根屏上新增数据容器。`key`、`name`。不占图层 |
|
|
162
166
|
| `removeComponent` | 删除组件 |
|
|
163
167
|
| `setComponentConfig` | 按路径改配置,`configPatches` 为 `[{ path, value }]` |
|
|
164
168
|
| `setComponentLayout` | 改位置和尺寸:`left`、`top`、`width`、`height` |
|
|
@@ -174,6 +178,26 @@ easyv-screen screen document put <id> -f doc.json --if-match <revision>
|
|
|
174
178
|
|
|
175
179
|
交互事件的 `trigger` 是触发方式(如 `click`、`mouseEnter`),`actions` 里的 `component` 用 `$component(<数字 id>)` 指向目标。数字 id 是组件 key 里 `c-` 后面的数字。
|
|
176
180
|
|
|
181
|
+
## 面板、容器和数据容器
|
|
182
|
+
|
|
183
|
+
`document get` 会读出动态面板、引用面板、组件容器,以及根屏上的过滤器和数据容器。编辑器里已有的动态面板和引用面板,元素 key 是 `p-<id>`,引用面板的图层 key 是 `rp-<id>`,组件容器是 `k-<id>`。用 `addPanel` / `addContainer` 新建时,key 用你指定的名字,并在元素上带回 `id`。状态 key 是 `s-` 加子屏 id。过滤器和数据容器不占图层,分别在 `filters`、`dataContainers`。
|
|
184
|
+
|
|
185
|
+
从零搭建时,把动态面板、组件容器、过滤器和数据容器写进文档,一次 `document put`。改已经存在的大屏时用单独的命令:
|
|
186
|
+
|
|
187
|
+
```bash
|
|
188
|
+
easyv-screen panel create <id> --key panel-tabs --name 页签 --left 40 --top 80 --width 600 --height 360
|
|
189
|
+
easyv-screen panel state create <id> panel-tabs --name 详情
|
|
190
|
+
easyv-screen container update <id> repeat-1 --name 列表
|
|
191
|
+
easyv-screen filter update <id> unit-filter --content "return data"
|
|
192
|
+
easyv-screen data-container delete <id> sales-dc
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
`panel`、`container` 还有 `list`、`get`、`update`、`delete`。`panel state` 同样有这一套,状态 key 是 `s-` 加子屏 id,至少保留一个状态。过滤器和数据容器挂在根屏上。删除动态面板和组件容器会进回收站。
|
|
196
|
+
|
|
197
|
+
不能把组件放进面板或容器,也不能改状态里面的组件。`parentKey` 只能指向分组。引用面板和万能组件不能新建。`element.bindContainer`、`element.bindFilter` 仍不能调用。`document put` 少了已有的面板、容器、过滤器或数据容器,仍会整单拒绝。
|
|
198
|
+
|
|
199
|
+
已有大屏里这三类对象怎么认,见技能 `easyv-screen-shared` 的 `references/panels-containers.md`。用自定义事件切到某个面板状态时,见同一技能的 `references/custom-events.md`。组件选型见同一技能的 `references/component-selection.md`。
|
|
200
|
+
|
|
177
201
|
其他常用命令:
|
|
178
202
|
|
|
179
203
|
```bash
|
|
@@ -263,12 +287,12 @@ easyv config set secretkey <Secret Key>
|
|
|
263
287
|
|
|
264
288
|
| 技能 | 什么时候用 |
|
|
265
289
|
| --- | --- |
|
|
266
|
-
| `easyv-screen-shared` |
|
|
267
|
-
| `easyv-screen-build` |
|
|
268
|
-
| `easyv-screen-edit` |
|
|
269
|
-
| `easyv-screen-data` |
|
|
270
|
-
| `easyv-screen-debug` |
|
|
271
|
-
| `easyv-component-dev` |
|
|
290
|
+
| `easyv-screen-shared` | 每次操作前都先读:工作台、登录、找到大屏、revision、发布或删除前确认。选型、事件、面板容器、预览和发布链接也在这里 |
|
|
291
|
+
| `easyv-screen-build` | 从零搭建一块大屏。接数据和配交互交给下面两个技能 |
|
|
292
|
+
| `easyv-screen-edit` | 改已有大屏的组件、配置、交互和图层,以及发布、取消发布和截图 |
|
|
293
|
+
| `easyv-screen-data` | 查、改、删数据源,给组件接数据或填静态数据 |
|
|
294
|
+
| `easyv-screen-debug` | 排查单个组件的数据来源和交互。组件不显示时改看文档里的显隐 |
|
|
295
|
+
| `easyv-component-dev` | 从零开发组件并上传。放进大屏交给搭建或修改 |
|
|
272
296
|
|
|
273
297
|
## 输出和退出码
|
|
274
298
|
|
|
@@ -0,0 +1,226 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.registerElements = registerElements;
|
|
4
|
+
const client_1 = require("../client");
|
|
5
|
+
const output_1 = require("../output");
|
|
6
|
+
const auth_1 = require("./auth");
|
|
7
|
+
/**
|
|
8
|
+
* 动态面板、面板状态、过滤器、组件容器、数据容器。
|
|
9
|
+
* 从零搭建优先把它们写进文档一次提交;这些命令用于改已经存在的大屏。
|
|
10
|
+
*/
|
|
11
|
+
function registerElements(program) {
|
|
12
|
+
const panel = program.command('panel').description('动态面板。引用面板不在这里');
|
|
13
|
+
registerPlacement(panel, 'panels', '动态面板');
|
|
14
|
+
registerStates(panel);
|
|
15
|
+
registerPlacement(program.command('container').description('组件容器'), 'component-containers', '组件容器');
|
|
16
|
+
registerNamed(program.command('filter').description('过滤器,挂在根屏上'), 'filters', '过滤器', true);
|
|
17
|
+
registerNamed(program.command('data-container').description('数据容器,挂在根屏上'), 'data-containers', '数据容器', false);
|
|
18
|
+
}
|
|
19
|
+
function registerPlacement(command, segment, label) {
|
|
20
|
+
command.command('list')
|
|
21
|
+
.description(`列出${label}`)
|
|
22
|
+
.argument('<screenId>', '大屏 id')
|
|
23
|
+
.action(async function (screenId) {
|
|
24
|
+
await run(this, () => (0, client_1.createClient)().request('GET', `/screens/${screenId}/${segment}`));
|
|
25
|
+
});
|
|
26
|
+
command.command('get')
|
|
27
|
+
.description(`查看${label}`)
|
|
28
|
+
.argument('<screenId>')
|
|
29
|
+
.argument('<key>', '文档 key')
|
|
30
|
+
.action(async function (screenId, key) {
|
|
31
|
+
await run(this, () => (0, client_1.createClient)().request('GET', `/screens/${screenId}/${segment}/${encodeURIComponent(key)}`));
|
|
32
|
+
});
|
|
33
|
+
command.command('create')
|
|
34
|
+
.description(`新建${label}`)
|
|
35
|
+
.argument('<screenId>')
|
|
36
|
+
.requiredOption('--key <key>', '稳定的文档 key,例如 panel-tabs')
|
|
37
|
+
.option('--name <name>')
|
|
38
|
+
.option('--left <n>')
|
|
39
|
+
.option('--top <n>')
|
|
40
|
+
.option('--width <n>')
|
|
41
|
+
.option('--height <n>')
|
|
42
|
+
.option('--parent <key>', '放到某个分组里,只能是已有分组')
|
|
43
|
+
.option('--index <n>', '在兄弟图层中的位置,从 0 开始')
|
|
44
|
+
.action(async function (screenId, options) {
|
|
45
|
+
await run(this, () => (0, client_1.createClient)().request('POST', `/screens/${screenId}/${segment}`, {
|
|
46
|
+
body: placementBody(options, true),
|
|
47
|
+
}));
|
|
48
|
+
});
|
|
49
|
+
command.command('update')
|
|
50
|
+
.description(`修改${label}的名称或位置`)
|
|
51
|
+
.argument('<screenId>')
|
|
52
|
+
.argument('<key>')
|
|
53
|
+
.option('--name <name>')
|
|
54
|
+
.option('--left <n>')
|
|
55
|
+
.option('--top <n>')
|
|
56
|
+
.option('--width <n>')
|
|
57
|
+
.option('--height <n>')
|
|
58
|
+
.action(async function (screenId, key, options) {
|
|
59
|
+
await run(this, () => (0, client_1.createClient)().request('PATCH', `/screens/${screenId}/${segment}/${encodeURIComponent(key)}`, {
|
|
60
|
+
body: placementBody(options, false),
|
|
61
|
+
}));
|
|
62
|
+
});
|
|
63
|
+
command.command('delete')
|
|
64
|
+
.description(`删除${label}。面板和组件容器进入回收站`)
|
|
65
|
+
.argument('<screenId>')
|
|
66
|
+
.argument('<key>')
|
|
67
|
+
.action(async function (screenId, key) {
|
|
68
|
+
await run(this, () => (0, client_1.createClient)().request('DELETE', `/screens/${screenId}/${segment}/${encodeURIComponent(key)}`));
|
|
69
|
+
});
|
|
70
|
+
}
|
|
71
|
+
function registerStates(panel) {
|
|
72
|
+
const state = panel.command('state').description('动态面板的状态');
|
|
73
|
+
state.command('list')
|
|
74
|
+
.description('列出动态面板的状态')
|
|
75
|
+
.argument('<screenId>')
|
|
76
|
+
.argument('<panelKey>')
|
|
77
|
+
.action(async function (screenId, panelKey) {
|
|
78
|
+
await run(this, () => (0, client_1.createClient)().request('GET', statePath(screenId, panelKey)));
|
|
79
|
+
});
|
|
80
|
+
state.command('get')
|
|
81
|
+
.description('查看一个状态')
|
|
82
|
+
.argument('<screenId>')
|
|
83
|
+
.argument('<panelKey>')
|
|
84
|
+
.argument('<stateKey>', '状态 key,形如 s-88001')
|
|
85
|
+
.action(async function (screenId, panelKey, stateKey) {
|
|
86
|
+
await run(this, () => (0, client_1.createClient)().request('GET', `${statePath(screenId, panelKey)}/${encodeURIComponent(stateKey)}`));
|
|
87
|
+
});
|
|
88
|
+
state.command('create')
|
|
89
|
+
.description('给动态面板新增一个空状态')
|
|
90
|
+
.argument('<screenId>')
|
|
91
|
+
.argument('<panelKey>')
|
|
92
|
+
.option('--name <name>', '不传则按「状态N」命名')
|
|
93
|
+
.action(async function (screenId, panelKey, options) {
|
|
94
|
+
await run(this, () => (0, client_1.createClient)().request('POST', statePath(screenId, panelKey), {
|
|
95
|
+
body: { ...(options.name != null ? { name: options.name } : {}) },
|
|
96
|
+
}));
|
|
97
|
+
});
|
|
98
|
+
state.command('update')
|
|
99
|
+
.description('重命名一个状态')
|
|
100
|
+
.argument('<screenId>')
|
|
101
|
+
.argument('<panelKey>')
|
|
102
|
+
.argument('<stateKey>')
|
|
103
|
+
.requiredOption('--name <name>')
|
|
104
|
+
.action(async function (screenId, panelKey, stateKey, options) {
|
|
105
|
+
await run(this, () => (0, client_1.createClient)().request('PATCH', `${statePath(screenId, panelKey)}/${encodeURIComponent(stateKey)}`, {
|
|
106
|
+
body: { name: options.name },
|
|
107
|
+
}));
|
|
108
|
+
});
|
|
109
|
+
state.command('delete')
|
|
110
|
+
.description('删除一个状态。至少保留一个')
|
|
111
|
+
.argument('<screenId>')
|
|
112
|
+
.argument('<panelKey>')
|
|
113
|
+
.argument('<stateKey>')
|
|
114
|
+
.action(async function (screenId, panelKey, stateKey) {
|
|
115
|
+
await run(this, () => (0, client_1.createClient)().request('DELETE', `${statePath(screenId, panelKey)}/${encodeURIComponent(stateKey)}`));
|
|
116
|
+
});
|
|
117
|
+
}
|
|
118
|
+
function registerNamed(command, segment, label, withFilterBody) {
|
|
119
|
+
command.command('list')
|
|
120
|
+
.description(`列出${label}`)
|
|
121
|
+
.argument('<screenId>')
|
|
122
|
+
.action(async function (screenId) {
|
|
123
|
+
await run(this, () => (0, client_1.createClient)().request('GET', `/screens/${screenId}/${segment}`));
|
|
124
|
+
});
|
|
125
|
+
command.command('get')
|
|
126
|
+
.description(`查看${label}`)
|
|
127
|
+
.argument('<screenId>')
|
|
128
|
+
.argument('<key>')
|
|
129
|
+
.action(async function (screenId, key) {
|
|
130
|
+
await run(this, () => (0, client_1.createClient)().request('GET', `/screens/${screenId}/${segment}/${encodeURIComponent(key)}`));
|
|
131
|
+
});
|
|
132
|
+
const create = command.command('create')
|
|
133
|
+
.description(`新建${label}`)
|
|
134
|
+
.argument('<screenId>')
|
|
135
|
+
.requiredOption('--key <key>')
|
|
136
|
+
.requiredOption('--name <name>');
|
|
137
|
+
if (withFilterBody) {
|
|
138
|
+
create
|
|
139
|
+
.option('--content <content>', '过滤器函数体,默认 return data')
|
|
140
|
+
.option('--callback-keys <keys>', '逗号分隔的回调参数名');
|
|
141
|
+
}
|
|
142
|
+
create.action(async function (screenId, options) {
|
|
143
|
+
await run(this, () => (0, client_1.createClient)().request('POST', `/screens/${screenId}/${segment}`, {
|
|
144
|
+
body: namedBody(options, withFilterBody),
|
|
145
|
+
}));
|
|
146
|
+
});
|
|
147
|
+
const update = command.command('update')
|
|
148
|
+
.description(`修改${label}`)
|
|
149
|
+
.argument('<screenId>')
|
|
150
|
+
.argument('<key>');
|
|
151
|
+
if (withFilterBody) {
|
|
152
|
+
update
|
|
153
|
+
.option('--name <name>')
|
|
154
|
+
.option('--content <content>', '过滤器函数体')
|
|
155
|
+
.option('--callback-keys <keys>', '逗号分隔的回调参数名');
|
|
156
|
+
}
|
|
157
|
+
else {
|
|
158
|
+
update.requiredOption('--name <name>');
|
|
159
|
+
}
|
|
160
|
+
update.action(async function (screenId, key, options) {
|
|
161
|
+
await run(this, () => (0, client_1.createClient)().request('PATCH', `/screens/${screenId}/${segment}/${encodeURIComponent(key)}`, {
|
|
162
|
+
body: namedBody(options, withFilterBody),
|
|
163
|
+
}));
|
|
164
|
+
});
|
|
165
|
+
command.command('delete')
|
|
166
|
+
.description(`删除${label}`)
|
|
167
|
+
.argument('<screenId>')
|
|
168
|
+
.argument('<key>')
|
|
169
|
+
.action(async function (screenId, key) {
|
|
170
|
+
await run(this, () => (0, client_1.createClient)().request('DELETE', `/screens/${screenId}/${segment}/${encodeURIComponent(key)}`));
|
|
171
|
+
});
|
|
172
|
+
}
|
|
173
|
+
function statePath(screenId, panelKey) {
|
|
174
|
+
return `/screens/${screenId}/panels/${encodeURIComponent(panelKey)}/states`;
|
|
175
|
+
}
|
|
176
|
+
function placementBody(options, creating) {
|
|
177
|
+
const layout = layoutOf(options);
|
|
178
|
+
const index = options.index != null ? integerOption(options.index, 'index') : undefined;
|
|
179
|
+
return {
|
|
180
|
+
...(creating ? { key: options.key } : {}),
|
|
181
|
+
...(options.name != null ? { name: options.name } : {}),
|
|
182
|
+
...(layout != null ? { layout } : {}),
|
|
183
|
+
...(options.parent != null ? { parentKey: options.parent } : {}),
|
|
184
|
+
...(index != null ? { index } : {}),
|
|
185
|
+
};
|
|
186
|
+
}
|
|
187
|
+
function namedBody(options, withFilterBody) {
|
|
188
|
+
return {
|
|
189
|
+
...(options.key != null ? { key: options.key } : {}),
|
|
190
|
+
...(options.name != null ? { name: options.name } : {}),
|
|
191
|
+
...(withFilterBody && options.content != null ? { content: options.content } : {}),
|
|
192
|
+
...(withFilterBody && options.callbackKeys != null
|
|
193
|
+
? { callbackKeys: options.callbackKeys.split(',').map(item => item.trim()).filter(item => item.length > 0) }
|
|
194
|
+
: {}),
|
|
195
|
+
};
|
|
196
|
+
}
|
|
197
|
+
function layoutOf(options) {
|
|
198
|
+
const layout = {};
|
|
199
|
+
for (const field of ['left', 'top', 'width', 'height']) {
|
|
200
|
+
const value = options[field];
|
|
201
|
+
if (value != null)
|
|
202
|
+
layout[field] = numberOption(value, field);
|
|
203
|
+
}
|
|
204
|
+
return Object.keys(layout).length > 0 ? layout : undefined;
|
|
205
|
+
}
|
|
206
|
+
function numberOption(value, name) {
|
|
207
|
+
const parsed = Number(value);
|
|
208
|
+
if (!Number.isFinite(parsed))
|
|
209
|
+
throw new Error(`${name} 必须是数字`);
|
|
210
|
+
return parsed;
|
|
211
|
+
}
|
|
212
|
+
function integerOption(value, name) {
|
|
213
|
+
const parsed = numberOption(value, name);
|
|
214
|
+
if (!Number.isInteger(parsed) || parsed < 0)
|
|
215
|
+
throw new Error(`${name} 必须是大于等于 0 的整数`);
|
|
216
|
+
return parsed;
|
|
217
|
+
}
|
|
218
|
+
async function run(command, call) {
|
|
219
|
+
try {
|
|
220
|
+
const result = await call();
|
|
221
|
+
(0, output_1.emit)((0, auth_1.globalJson)(command), result, () => console.log(JSON.stringify(result, null, 2)));
|
|
222
|
+
}
|
|
223
|
+
catch (error) {
|
|
224
|
+
(0, client_1.exitOnError)(error);
|
|
225
|
+
}
|
|
226
|
+
}
|
package/dist/index.js
CHANGED
|
@@ -5,6 +5,7 @@ const auth_1 = require("./commands/auth");
|
|
|
5
5
|
const component_1 = require("./commands/component");
|
|
6
6
|
const data_1 = require("./commands/data");
|
|
7
7
|
const debug_1 = require("./commands/debug");
|
|
8
|
+
const elements_1 = require("./commands/elements");
|
|
8
9
|
const screen_1 = require("./commands/screen");
|
|
9
10
|
const skills_1 = require("./commands/skills");
|
|
10
11
|
const update_1 = require("./commands/update");
|
|
@@ -19,6 +20,7 @@ program
|
|
|
19
20
|
.option('--json', '输出 JSON。现在默认就是 JSON,这个参数可以不写');
|
|
20
21
|
(0, auth_1.registerAuth)(program);
|
|
21
22
|
(0, screen_1.registerScreen)(program);
|
|
23
|
+
(0, elements_1.registerElements)(program);
|
|
22
24
|
(0, component_1.registerComponent)(program);
|
|
23
25
|
(0, data_1.registerData)(program);
|
|
24
26
|
(0, debug_1.registerDebug)(program);
|
package/package.json
CHANGED
|
@@ -1,14 +1,16 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: easyv-component-dev
|
|
3
|
-
description: 从零开发一个 EasyV
|
|
3
|
+
description: 从零开发一个 EasyV 组件并上传到平台。按组件规范定义配置项、静态数据、触发事件和接收的动作,打包签名后发布,返回 module 和 version。当官方组件和当前空间已发布的自定义组件都不合适,或需要定制可视化时使用。放进大屏交给 easyv-screen-build 或 easyv-screen-edit。开始前先读 easyv-screen-shared。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# 从零开发 EasyV 组件
|
|
7
7
|
|
|
8
|
+
先读 [easyv-screen-shared](../easyv-screen-shared/SKILL.md)。上传会写到当前登录的空间,执行前向用户确认。
|
|
9
|
+
|
|
8
10
|
组件是 React 组件。配置项、事件和动作都声明在 `config/main.json`,平台据此渲染配置面板和交互选项。
|
|
9
11
|
完整字段说明见 [component-spec.md](references/component-spec.md)。配置项的控件类型、分组和显隐见 [configuration.md](references/configuration.md)。图片、视频等静态资源的上传、配置和拼接见 [assets.md](references/assets.md)。
|
|
10
12
|
|
|
11
|
-
先读 [component-selection.md](../easyv-screen-
|
|
13
|
+
先读 [component-selection.md](../easyv-screen-shared/references/component-selection.md)。命中其中的官方组件时不要从零开发。没有命中的,按那份文档里的顺序查官方组件和空间组件。两边都不合适,再从零开发。
|
|
12
14
|
|
|
13
15
|
## 流程
|
|
14
16
|
|
|
@@ -22,7 +24,7 @@ description: 从零开发一个 EasyV 组件并上传到平台。按组件规范
|
|
|
22
24
|
4. 按下面的「easyv-cli」准备打包工具和签名密钥。没装好、密钥没配好就不要执行打包。
|
|
23
25
|
5. `easyv-screen component publish <目录名>`。它会打包、签名并上传;如果平台已有同名组件且版本不比本地高,
|
|
24
26
|
会自动把补丁号加一后重新打包再上传。
|
|
25
|
-
6. 上传结果里 `status` 为 `published`
|
|
27
|
+
6. 上传结果里 `status` 为 `published` 后,把返回的 `module` 和 `version` 交给 `easyv-screen-build` 或 `easyv-screen-edit` 放进大屏。已经在大屏里的实例不会跟着升级。
|
|
26
28
|
|
|
27
29
|
## easyv-cli
|
|
28
30
|
|
|
@@ -1,25 +1,17 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: easyv-screen-build
|
|
3
|
-
description: 从零搭建一个 EasyV
|
|
3
|
+
description: 从零搭建一个 EasyV 可视化大屏。先判断用现成组件还是从零开发组件,再创建大屏、写入画布和组件、校验布局。当用户要新建大屏、做一块看板或可视化页面时使用。接数据交给 easyv-screen-data,配交互交给 easyv-screen-edit。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# 从零搭建大屏
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
先读 [easyv-screen-shared](../easyv-screen-shared/SKILL.md),再按下面搭建。
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
## 组件从哪来
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
新增组件前先读 [component-selection.md](../easyv-screen-shared/references/component-selection.md)。文档里已有对应 module 的,直接用。没有的,按那份文档里的顺序查官方组件和空间组件。
|
|
13
13
|
|
|
14
|
-
|
|
15
|
-
按中文 `name` 和 `category` 判断用途。
|
|
16
|
-
2. 官方组件都不合适时,再 `easyv-screen component list --source space --keyword <中文名>` 查当前空间自己开发、且已发布的组件。
|
|
17
|
-
3. 拿不准某个组件是否合适时,`easyv-screen component schema <module>` 看它的 `dataFields`(需要什么数据)、
|
|
18
|
-
`triggers`(能发出什么事件)和 `size`(默认尺寸)。`fields` 很大,不要整份读,改配置时用下面的 `component fields` 查。
|
|
19
|
-
父组件带图层时,先 `easyv-screen component children <module>` 拿到子组件 `module`,再用
|
|
20
|
-
`component schema <module> --child <子组件>` 和 `component fields <module> --child <子组件> --keyword "<意图>"`。
|
|
21
|
-
4. `requiresPreset: true` 的组件暂时不能通过 CLI 新增,换一个组件。
|
|
22
|
-
5. 官方组件和空间组件都表达不好需求时,用 `easyv-component-dev` 技能从零开发并上传,再引用返回的 module 和版本。
|
|
14
|
+
多状态切换、一块区域里按数据行重复组件、多个组件共用一份取数,分别是动态面板、组件容器、数据容器。先读 [panels-containers.md](../easyv-screen-shared/references/panels-containers.md)。从零搭建时把它们写进同一份 `doc.json`:面板和容器放进 `layers` 与 `elements`,`states` 留空数组;过滤器和数据容器写在根上的 `filters`、`dataContainers`。和画布一起一次 `document put`,不要逐个调用 `panel create`、`container create`、`filter create`、`data-container create`。文档创建的面板只带一个空状态;还要更多状态时,文档落库后再用 `panel state create`。建完重新 `document get`,用返回的 `id` 和 `states[].screenId` 写自定义事件。不能往面板或容器里面放组件,也不能新建引用面板。选项卡本身用 `tabV2`,它不包含面板里的各份状态。
|
|
23
15
|
|
|
24
16
|
## 步骤
|
|
25
17
|
|
|
@@ -35,17 +27,8 @@ description: 从零搭建一个 EasyV 可视化大屏。先判断用现成组件
|
|
|
35
27
|
5. `easyv-screen screen apply <id> -f ops.json --if-match <revision>` 一次提交。
|
|
36
28
|
返回 `COMPONENT_CONFIG_INVALID` 时按 `details.elements[].unknownPaths` 重新查路径再提交。
|
|
37
29
|
6. `easyv-screen screen validate <id>` 检查。`ELEMENT_OUT_OF_CANVAS`、`ELEMENT_OVERLAP`、`ELEMENT_HIDDEN` 说明布局有问题,调整后再提交。
|
|
38
|
-
7.
|
|
39
|
-
8.
|
|
40
|
-
|
|
41
|
-
## 看实际效果
|
|
42
|
-
|
|
43
|
-
用 `easyv-screen config list` 拿到的 `baseUrl` 拼地址,在浏览器里打开。
|
|
44
|
-
|
|
45
|
-
- 预览链接:`{baseUrl}/preview/{screenId}`。需要登录。优先用已经打开、并且登录过这个工作台的浏览器访问。
|
|
46
|
-
- 发布链接:`{baseUrl}/shareScreen/{shareInfo}`。`shareInfo` 是 `{ screenId: <大屏 id> }` 的 base64,id 为数字时不要加引号。大屏已公开发布时,打开这个链接不用登录。
|
|
47
|
-
|
|
48
|
-
预览链接要求登录、而当前浏览器没有登录时,改打开发布链接。大屏本来就是公开发布的,直接打开,不要再执行发布或取消发布。只有当前大屏未发布时,才先跟用户确认,再临时公开发布:`easyv-screen screen publish <id>`,看完效果后执行 `easyv-screen screen unpublish <id>` 关掉。这次发布只用于查看。
|
|
30
|
+
7. 截图、打开预览或发布链接,按共用规则的「查看和发布」。
|
|
31
|
+
8. 交付时的正式发布也按那一节:先向用户确认,再执行 `screen publish`。
|
|
49
32
|
|
|
50
33
|
## 文档要点
|
|
51
34
|
|
|
@@ -1,13 +1,15 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: easyv-screen-data
|
|
3
|
-
description: 给 EasyV
|
|
3
|
+
description: 给 EasyV 大屏的组件接数据:查已有数据源、新建、修改或删除数据库和 API 连接、看表结构和预览数据、把组件绑定到数据源或填静态数据。当用户要给组件接数据、换数据源、改连接或填静态数据时使用。开始前先读 easyv-screen-shared。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# 给组件接数据
|
|
7
7
|
|
|
8
|
+
先读 [easyv-screen-shared](../easyv-screen-shared/SKILL.md)。绑定要用大屏 id 和文档 `revision`,没有 id 时按那里找到大屏。
|
|
9
|
+
|
|
8
10
|
## 先看有没有现成的数据源
|
|
9
11
|
|
|
10
|
-
`easyv-screen data source list
|
|
12
|
+
`easyv-screen data source list`,可用 `--type mysql` 这类参数过滤。详情用 `data source get <dataId>`,密码只会显示为 `******`。
|
|
11
13
|
|
|
12
14
|
## 新建数据源
|
|
13
15
|
|
|
@@ -16,19 +18,25 @@ description: 给 EasyV 大屏的组件接数据:查已有数据源、新建数
|
|
|
16
18
|
```
|
|
17
19
|
easyv-screen data source create --name "业务库" --type mysql \
|
|
18
20
|
--addr 10.0.0.8 --port 3306 --username app --database biz \
|
|
19
|
-
--password-env DB_PASSWORD
|
|
21
|
+
--password-env DB_PASSWORD
|
|
20
22
|
```
|
|
21
23
|
|
|
22
24
|
`--type` 常用 `mysql`、`postgresql`、`clickhouse`、`oracle`、`mssql`、`api`、`csv`。
|
|
23
|
-
API 类型用 `--base-url`。建完用 `data source test <dataId
|
|
25
|
+
API 类型用 `--base-url`。建完用 `data source test <dataId>` 确认连通。
|
|
24
26
|
|
|
25
27
|
连接测试、表结构和预览依赖数据源服务。如果返回 `DATASOURCE_SERVICE_UNAVAILABLE`,说明服务地址还没配置,
|
|
26
28
|
告诉用户这一步暂时做不了,数据源本身已经创建。
|
|
27
29
|
|
|
30
|
+
## 修改或删除数据源
|
|
31
|
+
|
|
32
|
+
改名称、地址、端口、账号、库名或 API 地址用 `data source update <dataId>`。类型在创建时确定,更新时不能改。没写上的字段保持原值,不传密码就保留原密码。密码仍然只走 `--password-env` 或 `--password-stdin`。
|
|
33
|
+
|
|
34
|
+
删除用 `easyv-screen data source delete <dataId>`。执行前向用户确认。
|
|
35
|
+
|
|
28
36
|
## 确认字段
|
|
29
37
|
|
|
30
|
-
`data source tables <dataId
|
|
31
|
-
`data source preview <dataId> --sql "select ..."
|
|
38
|
+
`data source tables <dataId>` 看有哪些表,`data source columns <dataId> --table <表名>` 看字段,
|
|
39
|
+
`data source preview <dataId> --sql "select ..."` 看样本。用样本核对组件需要的字段。
|
|
32
40
|
|
|
33
41
|
## 绑定到组件
|
|
34
42
|
|
|
@@ -46,8 +54,10 @@ API 类型用 `--base-url`。建完用 `data source test <dataId> --json` 确认
|
|
|
46
54
|
}
|
|
47
55
|
```
|
|
48
56
|
|
|
49
|
-
用 `easyv-screen screen apply <id> -f ops.json --if-match <revision
|
|
57
|
+
用 `easyv-screen screen apply <id> -f ops.json --if-match <revision>` 提交。
|
|
50
58
|
`data_id` 必须是当前团队的数据源,否则校验报 `DATA_SOURCE_NOT_FOUND`。
|
|
51
59
|
|
|
52
60
|
只用静态数据时,用 `setComponentStaticData`,`data` 传对象数组,`fields` 传字段说明。
|
|
53
61
|
改回静态数据用 `element.unbindData`。
|
|
62
|
+
|
|
63
|
+
数据容器是大屏上单独的一份取数。从零搭建时写进文档一次 `document put`。改已有大屏时用 `easyv-screen data-container` 新建、改名或删除。`element.bindContainer` 和 `element.bindFilter` 仍然不能调用,组件自己的数据源继续用 `element.bindData`。区别见 [panels-containers.md](../easyv-screen-shared/references/panels-containers.md)。
|
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: easyv-screen-debug
|
|
3
|
-
description: 排查 EasyV
|
|
3
|
+
description: 排查 EasyV 大屏上单个组件的配置并判断原因:数据绑定、它触发了谁、谁触发了它。当用户反馈点击没反应、联动不对、数据不对或组件不显示时使用。不显示要看文档里的显隐,这条命令不返回显隐。开始前先读 easyv-screen-shared。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# 排查大屏
|
|
7
7
|
|
|
8
|
+
先读 [easyv-screen-shared](../easyv-screen-shared/SKILL.md)。没有大屏 id 时按那里找到大屏。组件 key 从 `screen document get` 的文档里取。
|
|
9
|
+
|
|
8
10
|
`easyv-screen debug` 只取出一个组件的配置,不下结论。拿到数据后自己判断原因,再用一句人话告诉用户。
|
|
9
11
|
|
|
10
12
|
下面这些已经有别的命令,不要再用 debug 去要:
|
|
@@ -34,14 +36,16 @@ easyv-screen debug <screenId> <key>
|
|
|
34
36
|
- `data.staticData`:文档里的静态数据。绑了数据源时它也可能还在。
|
|
35
37
|
- `outgoing`:这个组件自己的事件,结构与文档里的 `interactions.events` 相同。动作的 `component` 是它指向的目标。
|
|
36
38
|
- `incoming`:别的组件里,动作 `component` 指向它的事件。每项的 `key` 是来源组件。
|
|
37
|
-
- `refs`:上面这些事件里出现的 `$component(...)`
|
|
38
|
-
- `location
|
|
39
|
+
- `refs`:上面这些事件里出现的 `$component(...)`、`$panel(...)`、`$container(...)`、`$state(...)`、`$super(...)` 引用,解析成文档 key、名称和 `found`。`found` 为 false 表示文档里没有这个对象。
|
|
40
|
+
- `location`:组件在某个面板或容器的状态里时才有,含 `parentKey`、`parentKind`、`stateKey`、`stateName`。没有该字段就是在大屏根上。
|
|
41
|
+
|
|
42
|
+
动态面板、组件容器、过滤器和数据容器在文档里的 key,见 [panels-containers.md](../easyv-screen-shared/references/panels-containers.md)。`dataBinding` 为 null 时,画面上的数据仍可能来自数据容器或组件容器下发。文档能看到数据容器在不在,看不到它和组件的绑定。
|
|
39
43
|
|
|
40
44
|
## 怎么判断
|
|
41
45
|
|
|
42
46
|
按用户的具体问题看对应的字段,不要套固定的故障类型。
|
|
43
47
|
|
|
44
|
-
- 点击没反应:看 `outgoing` 里有没有该触发方式、动作有没有目标、`refs` 里目标是否 `found`。只关心一种触发就加 `--trigger
|
|
48
|
+
- 点击没反应:看 `outgoing` 里有没有该触发方式、动作有没有目标、`refs` 里目标是否 `found`。只关心一种触发就加 `--trigger`。切面板时动作是 `switchState`,`stateId` 形如 `$state(<子屏 id>)`,字段见 [custom-events.md](../easyv-screen-shared/references/custom-events.md)。
|
|
45
49
|
- 被别的组件影响:看 `incoming`,来源是每一项的 `key`。
|
|
46
50
|
- 数据不对:先看 `data`。绑定了数据源再按 `data_id` 查连接和预览。
|
|
47
51
|
- 不显示:debug 不返回显隐。用 `screen document get` 看该 key 和祖先图层的 `visible`。
|
|
@@ -1,27 +1,31 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: easyv-screen-edit
|
|
3
|
-
description:
|
|
3
|
+
description: 修改已经存在的 EasyV 大屏:添加或删除组件、改配置和名称、批量修改、配置交互、调整显隐图层和成组、升级组件版本,以及发布、取消发布和截图。当用户要改大屏、加组件、改布局、做点击联动、发布或查看已有大屏时使用。开始前先读 easyv-screen-shared。接数据交给 easyv-screen-data。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# 修改大屏
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
先读 [easyv-screen-shared](../easyv-screen-shared/SKILL.md)。没有大屏 id 时按那里找到。然后 `easyv-screen screen document get <id> -o doc.json` 拿到当前文档和 `revision`。
|
|
9
9
|
|
|
10
|
-
往大屏里新增组件时,先读 [component-selection.md](../easyv-screen-
|
|
10
|
+
往大屏里新增组件时,先读 [component-selection.md](../easyv-screen-shared/references/component-selection.md),再写 `addComponent`。
|
|
11
11
|
|
|
12
12
|
## 用原子操作做局部修改
|
|
13
13
|
|
|
14
14
|
把操作写进 `ops.json`,格式 `{ "operations": [ ... ] }`,然后:
|
|
15
15
|
|
|
16
16
|
```
|
|
17
|
-
easyv-screen screen apply <id> -f ops.json --if-match <revision>
|
|
17
|
+
easyv-screen screen apply <id> -f ops.json --if-match <revision>
|
|
18
18
|
```
|
|
19
19
|
|
|
20
20
|
支持的操作(元素和图层都用文档 key):
|
|
21
21
|
|
|
22
22
|
| 操作 | 作用 | 关键字段 |
|
|
23
23
|
| --- | --- | --- |
|
|
24
|
-
| `addComponent` |
|
|
24
|
+
| `addComponent` | 新增组件,其余用组件默认配置。`parentKey` 只能是已有分组 | `key` `module` `version` `name` `layout` `configPatches` `data` `parentKey` `index` |
|
|
25
|
+
| `addPanel` | 新增动态面板,自带一个空状态 | `key` `name` `layout` `parentKey` `index` |
|
|
26
|
+
| `addContainer` | 新增组件容器,自带一个空子屏。名称最长 50 | `key` `name` `layout` `parentKey` `index` |
|
|
27
|
+
| `addFilter` | 在根屏上新增过滤器 | `key` `name` `content` `callbackKeys` |
|
|
28
|
+
| `addDataContainer` | 在根屏上新增数据容器,不占图层 | `key` `name` |
|
|
25
29
|
| `removeComponent` | 删除组件 | `key` |
|
|
26
30
|
| `setComponentConfig` | 按路径改配置 | `key` `configPatches`(`[{ path, value }]`) |
|
|
27
31
|
| `setComponentLayout` | 改位置尺寸 | `key` `layout`(`left` `top` `width` `height`) |
|
|
@@ -33,19 +37,21 @@ easyv-screen screen apply <id> -f ops.json --if-match <revision> --json
|
|
|
33
37
|
| `element.bindData` | 绑定数据源 | `key` `dataType` `data`(含 `data_id`) |
|
|
34
38
|
| `element.unbindData` | 改回静态数据 | `key` |
|
|
35
39
|
| `setLayerVisible` | 显隐 | `key` `visible` |
|
|
36
|
-
| `moveLayer` |
|
|
40
|
+
| `moveLayer` | 移动图层。`parentKey` 只能是已有分组,或空着移到根上 | `key` `parentKey` `index` |
|
|
37
41
|
| `groupLayers` | 成组 | `keys` `groupKey`(`g-` 开头) `name` |
|
|
38
42
|
| `ungroupLayer` | 解散分组 | `key` |
|
|
39
43
|
| `upgradeComponentVersion` | 升级组件版本 | `key` `version` |
|
|
40
44
|
| `screen.updateMeta` | 改大屏名称 | `name` |
|
|
41
45
|
|
|
42
|
-
改完跑 `screen validate <id
|
|
46
|
+
改完跑 `screen validate <id>`。
|
|
47
|
+
|
|
48
|
+
查数据源、新建或修改连接、看表和预览用 `easyv-screen-data`。表里的 `setComponentStaticData`、`element.bindData`、`element.unbindData` 只负责把结果写进文档。
|
|
43
49
|
|
|
44
50
|
## 交互事件
|
|
45
51
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
52
|
+
自定义事件的字段、触发方式和动作写在 [custom-events.md](../easyv-screen-shared/references/custom-events.md)。切换已有动态面板的状态用动作 `switchState`,示例也在那份说明里。
|
|
53
|
+
|
|
54
|
+
改已经存在的大屏时,动态面板、状态、过滤器、组件容器、数据容器用单独的命令增删改,不要为了改一个名称去重写整份文档。从零搭建仍把它们写进文档一次提交。命令和限制见 [panels-containers.md](../easyv-screen-shared/references/panels-containers.md)。状态里的组件不能作为 `apply` 的目标,也不能放进面板或容器。
|
|
49
55
|
|
|
50
56
|
## 改配置
|
|
51
57
|
|
|
@@ -60,3 +66,7 @@ easyv-screen screen apply <id> -f ops.json --if-match <revision> --json
|
|
|
60
66
|
## 批量修改
|
|
61
67
|
|
|
62
68
|
多个组件的修改放进同一个 `operations` 数组一次提交,任何一条不通过整批都不落库。
|
|
69
|
+
|
|
70
|
+
## 发布、取消发布和截图
|
|
71
|
+
|
|
72
|
+
截图、打开预览或发布链接、临时发布后关掉,以及交付时的正式发布,按共用规则的「查看和发布」。取消公开发布用 `easyv-screen screen unpublish <id>`,执行前向用户确认。
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: easyv-screen-shared
|
|
3
|
-
description: 使用 easyv-screen
|
|
3
|
+
description: 使用 easyv-screen 命令前先遵守的共用规则:确认工作台和登录、按名称找到大屏、写入时带上 revision、发布或删除前向用户确认。组件选型、自定义事件、动态面板、组件容器、数据容器,以及预览和发布链接也在这里。搭建、修改、接数据、排查或开发组件时都要先读这份技能。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# EasyV 大屏 CLI 共用规则
|
|
@@ -18,15 +18,36 @@ description: 使用 easyv-screen 命令操作 EasyV 大屏时的共用规则:
|
|
|
18
18
|
未登录时运行 `easyv-screen auth login`,把输出的授权地址交给用户,等用户在浏览器确认。
|
|
19
19
|
同一个工作台要登录另一个空间或团队时,用 `easyv-screen auth login --name <名称>`,再用 `auth use <名称>` 切换。
|
|
20
20
|
3. 一次登录只绑定一个空间和一个团队。`easyv-screen auth status` 会返回当前登录绑定的空间名称、空间 ID、团队名称和团队 ID。要操作别的团队,在同一个 baseURL 下换一个登录。
|
|
21
|
+
4. 还没有大屏 id 时,用 `easyv-screen screen list` 查找,`--keyword` 按名称过滤,`--group` 按分组过滤。分组 id 用 `easyv-screen screen groups`。详情用 `easyv-screen screen get <id>`。
|
|
21
22
|
|
|
22
23
|
## 写入规则
|
|
23
24
|
|
|
24
25
|
- 读文档拿到的 `revision` 要在写回时带上:`document put` 和 `apply` 都支持 `--if-match <revision>`。
|
|
25
26
|
返回 `REVISION_CONFLICT`(退出码 4)时,重新 `document get` 再合并,不要原样重试。
|
|
26
27
|
- 写完跑 `screen validate`。有 `error` 先修再继续;`warn` 告知用户即可。
|
|
27
|
-
-
|
|
28
|
+
- 发布、取消发布、删除、上传组件会生效到用户的空间。执行前用一句话向用户确认。
|
|
28
29
|
- 不要编造组件的配置字段。用 `component fields <module> --keyword` 查路径;用自己开发的组件时也可以对照 `main.json` 的 `configuration`。
|
|
29
30
|
- 不要编造子组件。用 `component children <module>` 列出父组件包里的子组件,再把返回的 `module` 传给 `component fields <module> --child <子组件>` 或 `component schema <module> --child <子组件>`。
|
|
31
|
+
- 动态面板、引用面板、组件容器、过滤器和数据容器按 [panels-containers.md](references/panels-containers.md) 处理。从零搭建写进文档一次提交。改已有大屏时用 `panel`、`panel state`、`container`、`filter`、`data-container` 做单个增删改。不能绑定,也不能改状态里面的组件。
|
|
32
|
+
|
|
33
|
+
## 平台说明
|
|
34
|
+
|
|
35
|
+
两种以上场景都会用到的平台事实写在 `references/`。用到再读,不要整份预读。以后新增这类说明,放在这个目录并在下面加一行。
|
|
36
|
+
|
|
37
|
+
- 新增组件前读 [component-selection.md](references/component-selection.md)。表里已有的 module 直接用;没有的按那份文档里的顺序查官方组件和空间组件。
|
|
38
|
+
- 配置交互,或排查点击、切换面板时,读 [custom-events.md](references/custom-events.md)。
|
|
39
|
+
- 动态面板、引用面板、组件容器、数据容器怎么认、命令能改什么,读 [panels-containers.md](references/panels-containers.md)。
|
|
40
|
+
|
|
41
|
+
## 查看和发布
|
|
42
|
+
|
|
43
|
+
`easyv-screen screen snapshot <id> -o preview.png` 截的是预览页,用来核对位置和显隐。要看组件真实渲染,用 `config list` 拿到的 `baseUrl` 在浏览器里打开。
|
|
44
|
+
|
|
45
|
+
- 预览链接:`{baseUrl}/bigscreen/{screenId}?sid=<空间id>&tid=<团队id>`。需要登录。优先用已经打开、并且登录过这个工作台的浏览器访问。
|
|
46
|
+
- 发布链接:`{baseUrl}/shareScreen/{shareInfo}`。`shareInfo` 是 `{ screenId: <大屏 id> }` 的 base64,id 为数字时不要加引号。大屏已公开发布时,打开这个链接不用登录。
|
|
47
|
+
|
|
48
|
+
预览链接要求登录、而当前浏览器没有登录时,改打开发布链接。大屏本来就是公开发布的,直接打开。只有当前大屏未发布、又必须看真实渲染时,才先向用户确认,再临时执行 `easyv-screen screen publish <id>`,看完后执行 `easyv-screen screen unpublish <id>`。这次发布只用于查看。
|
|
49
|
+
|
|
50
|
+
交付时的正式发布:先向用户确认,再执行 `easyv-screen screen publish <id>`。这次发布保持公开。
|
|
30
51
|
|
|
31
52
|
## 退出码
|
|
32
53
|
|
|
@@ -1,9 +1,23 @@
|
|
|
1
1
|
# 组件选型
|
|
2
2
|
|
|
3
|
-
新增组件之前先对照这里。命中某一条就用列出的官方 module
|
|
3
|
+
新增组件之前先对照这里。命中某一条就用列出的官方 module,不要再查列表,也不要再开发一个同类组件。
|
|
4
4
|
|
|
5
5
|
以后增加的选型往下表和后面的分节里追加,一条需求对应一个 module。
|
|
6
6
|
|
|
7
|
+
表里没有对应 module 的,按这个顺序选型。接口按需调用,不要一次把两类组件都拉下来:
|
|
8
|
+
|
|
9
|
+
1. `easyv-screen component list --keyword <中文名>` 查 EasyV 官方组件。列表只含已发布组件,不含定制组件。
|
|
10
|
+
按中文 `name` 和 `category` 判断用途。
|
|
11
|
+
2. 官方组件都不合适时,再 `easyv-screen component list --source space --keyword <中文名>` 查当前空间自己开发、且已发布的组件。
|
|
12
|
+
3. 拿不准某个组件是否合适时,`easyv-screen component schema <module>` 看它的 `dataFields`(需要什么数据)、
|
|
13
|
+
`triggers`(能发出什么事件)和 `size`(默认尺寸)。`fields` 很大,不要整份读,改配置时用 `component fields` 查。
|
|
14
|
+
父组件带图层时,先 `easyv-screen component children <module>` 拿到子组件 `module`,再用
|
|
15
|
+
`component schema <module> --child <子组件>` 和 `component fields <module> --child <子组件> --keyword "<意图>"`。
|
|
16
|
+
4. `requiresPreset: true` 的组件暂时不能通过 CLI 新增,换一个组件。
|
|
17
|
+
5. 官方组件和空间组件都表达不好需求时,用 `easyv-component-dev` 技能从零开发并上传,再引用返回的 module 和版本。
|
|
18
|
+
|
|
19
|
+
多状态切换、一块区域里按数据行重复组件、多个组件共用一份取数,分别是动态面板、组件容器、数据容器,不是再选一个组件。见 [panels-containers.md](panels-containers.md)。选项卡本身用 `tabV2`,它不包含面板里的各份状态。
|
|
20
|
+
|
|
7
21
|
| 需求 | module | 怎么用 |
|
|
8
22
|
| --- | --- | --- |
|
|
9
23
|
| 图片装饰、背景、图标等静态图 | `imageV2` | 不新开发。相对路径写入配置项「图片上传」,数据 `url` 留空 |
|