@easyv/screen-cli 0.1.4 → 0.1.6
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 +24 -3
- package/skills/easyv-screen-build/SKILL.md +35 -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 +24 -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 +3 -1
- package/spec/openapi.v1.yaml +829 -83
|
@@ -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,37 @@ 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
|
+
- 从 Figma 设计稿还原大屏时,读 [easyv-screen-build](../easyv-screen-build/SKILL.md) 的「从 Figma 设计稿还原」:先切图,再在本地用 React 和 Vite 验证,最后才上传组件并搭建大屏。
|
|
38
|
+
- 新增组件前读 [component-selection.md](references/component-selection.md)。表里已有的 module 直接用;没有的按那份文档里的顺序查官方组件和空间组件。
|
|
39
|
+
- 配置交互,或排查点击、切换面板时,读 [custom-events.md](references/custom-events.md)。
|
|
40
|
+
- 动态面板、引用面板、组件容器、数据容器怎么认、命令能改什么,读 [panels-containers.md](references/panels-containers.md)。
|
|
41
|
+
|
|
42
|
+
## 查看和发布
|
|
43
|
+
|
|
44
|
+
`easyv-screen screen snapshot <id> -o preview.png` 截的是预览页,用来核对位置和显隐。要看组件真实渲染,用 `config list` 拿到的 `baseUrl` 在浏览器里打开。
|
|
45
|
+
|
|
46
|
+
- 预览链接:`{baseUrl}/bigscreen/{screenId}?sid=<空间id>&tid=<团队id>`。需要登录。优先用已经打开、并且登录过这个工作台的浏览器访问。
|
|
47
|
+
- 发布链接:`{baseUrl}/shareScreen/{shareInfo}`。`shareInfo` 是 `{ screenId: <大屏 id> }` 的 base64,id 为数字时不要加引号。大屏已公开发布时,打开这个链接不用登录。
|
|
48
|
+
|
|
49
|
+
预览链接要求登录、而当前浏览器没有登录时,改打开发布链接。大屏本来就是公开发布的,直接打开。只有当前大屏未发布、又必须看真实渲染时,才先向用户确认,再临时执行 `easyv-screen screen publish <id>`,看完后执行 `easyv-screen screen unpublish <id>`。这次发布只用于查看。
|
|
50
|
+
|
|
51
|
+
交付时的正式发布:先向用户确认,再执行 `easyv-screen screen publish <id>`。这次发布保持公开。
|
|
30
52
|
|
|
31
53
|
## 退出码
|
|
32
54
|
|
|
@@ -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` 留空 |
|
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
# 自定义事件
|
|
2
|
+
|
|
3
|
+
事件写在发起动作的组件上,不写在被控制的组件上。用 `addComponentEvent` 追加,用 `updateComponentEvent` 整条替换,用 `deleteComponentEvent` 按 `eventId` 删除。
|
|
4
|
+
|
|
5
|
+
只对大屏根上 `elements` 里的组件。面板或容器某个状态里的组件不在这张表里,命令加不上事件。
|
|
6
|
+
|
|
7
|
+
`addComponentEvent` 只追加 `events`。不要改这个组件文档里的 `interactions.triggers` 和 `interactions.actions`,那是它能发出的事件和能接收的动作。
|
|
8
|
+
|
|
9
|
+
编辑画布里事件不执行。配完用预览页看。
|
|
10
|
+
|
|
11
|
+
## 事件结构
|
|
12
|
+
|
|
13
|
+
`event.id` 可以不写,服务端会补。动作和条件的 `id` 必须写,编辑器会丢掉没有 `id` 或 `name` 的动作。`id` 用 `action_`、`condition_` 加一小段不重复的字符。
|
|
14
|
+
|
|
15
|
+
动作对象把下面这些字段都带上,没用到的保持示例里的空值。缺字段时编辑器里这条动作会显示不出来。
|
|
16
|
+
|
|
17
|
+
```json
|
|
18
|
+
{
|
|
19
|
+
"op": "addComponentEvent",
|
|
20
|
+
"key": "c-88",
|
|
21
|
+
"event": {
|
|
22
|
+
"name": "事件",
|
|
23
|
+
"trigger": "click",
|
|
24
|
+
"conditionType": "all",
|
|
25
|
+
"conditions": [],
|
|
26
|
+
"reverse": false,
|
|
27
|
+
"actions": [
|
|
28
|
+
{
|
|
29
|
+
"id": "action_panel_state",
|
|
30
|
+
"name": "动作",
|
|
31
|
+
"action": "show",
|
|
32
|
+
"actionData": {},
|
|
33
|
+
"component": ["$component(88)"],
|
|
34
|
+
"stateId": "",
|
|
35
|
+
"componentScope": "current",
|
|
36
|
+
"componentConfig": {},
|
|
37
|
+
"unmount": true,
|
|
38
|
+
"agentType": "ai_agent",
|
|
39
|
+
"animation": { "type": "opacity", "timingFunction": "linear", "duration": 1000, "delay": 0 },
|
|
40
|
+
"translate": { "toX": 0, "toY": 0 },
|
|
41
|
+
"scale": { "x": 1, "y": 1, "origin": "50% 50%", "lock": true }
|
|
42
|
+
}
|
|
43
|
+
]
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
`trigger` 必须和源组件自己声明的值完全一致,区分大小写。用 `easyv-screen component schema <module>` 看 `triggers[].value`,不要按中文名猜。所有组件还可以用 `dataChange`,表示请求完成或数据变化,它不在组件自己的 `triggers` 里。
|
|
49
|
+
|
|
50
|
+
`conditionType` 用 `all`(全部满足)或 `one`(任一满足)。`conditions` 为空时动作总会执行。
|
|
51
|
+
|
|
52
|
+
字段条件:
|
|
53
|
+
|
|
54
|
+
```json
|
|
55
|
+
{
|
|
56
|
+
"id": "condition_tab_sales",
|
|
57
|
+
"name": "销售",
|
|
58
|
+
"type": "field",
|
|
59
|
+
"field": "content",
|
|
60
|
+
"compare": "==",
|
|
61
|
+
"expected": "销售",
|
|
62
|
+
"containerIndex": null,
|
|
63
|
+
"code": "return data"
|
|
64
|
+
}
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
`compare` 用 `==`、`!=`、`>`、`>=`、`<`、`<=`、`include`、`exclude`。`type` 为 `field` 时 `code` 不执行,仍写成 `"return data"`。载荷是数组时,任一条的字段对上即通过。
|
|
68
|
+
|
|
69
|
+
`reverse` 为 true 时,条件不通过会做反向动作。反向只覆盖 `show`、`hide`、`updateConfig`、`rotate`、`translate`、`scale`。`switchState`、`show/hide`、`updateData` 没有反向。
|
|
70
|
+
|
|
71
|
+
## 常用动作
|
|
72
|
+
|
|
73
|
+
目标写在 `component` 数组里。组件是 `$component(<数字 id>)`,数字 id 是 key 里 `c-` 后面的数字。分组是 `$group(group_...)`。面板见下一节。
|
|
74
|
+
|
|
75
|
+
| action | 效果 | 要改的字段 |
|
|
76
|
+
| --- | --- | --- |
|
|
77
|
+
| `show` / `hide` / `show/hide` | 显示、隐藏、来回切换 | `component`。隐藏时 `unmount: true` 会卸掉 DOM |
|
|
78
|
+
| `switchState` | 切到动态面板或引用面板的某个状态 | `component` 一项,`stateId` |
|
|
79
|
+
| `setIndex` | 按序号选中。面板和选项卡都能接 | `component` 一项,`actionDataFn` |
|
|
80
|
+
| `updateData` | 让目标重新取数 | `component` |
|
|
81
|
+
|
|
82
|
+
显隐切换用 `show/hide`。要「条件成立就显示,不成立就隐藏」时用一个 `show`,并把 `reverse` 设为 true。
|
|
83
|
+
|
|
84
|
+
`setIndex` 的 `actionData` 留 `{}`,序号写在 `actionDataFn` 里,例如 `"return 2;"`。序号从 1 开始,`0` 表示不选中。这个动作编辑器会加给动态面板,面板自己的 `actions` 声明里没有它。
|
|
85
|
+
|
|
86
|
+
## 用自定义事件切换动态面板
|
|
87
|
+
|
|
88
|
+
面板可以先用 `addPanel` 新建,再 `document get`。在 `elements` 里找到 `kind` 为 `panel` 的项,读它的 `id` 和 `states`。
|
|
89
|
+
|
|
90
|
+
- 动态面板:`component` 写 `["$panel(panel_<面板 id>)"]`。面板 id 是元素上的 `id`。编辑器里建的面板,key 是 `p-<id>`,`id` 就是这段数字。
|
|
91
|
+
- 引用面板:`component` 写 `["$panel(ref_<面板 id>)"]`。元素仍在 `p-<id>`,图层 key 才是 `rp-<id>`。
|
|
92
|
+
- `stateId` 写 `$state(<子屏 id>)`。子屏 id 是该状态的 `screenId`,也是状态 key `s-` 后面的数字。不要写状态序号,也不要写 `s-88001` 这种 key。
|
|
93
|
+
|
|
94
|
+
点一个按钮,切到名为「销售」的状态。假设面板 id 是 `12`,该状态 `screenId` 是 `88002`:
|
|
95
|
+
|
|
96
|
+
```json
|
|
97
|
+
{
|
|
98
|
+
"op": "addComponentEvent",
|
|
99
|
+
"key": "c-tab",
|
|
100
|
+
"event": {
|
|
101
|
+
"name": "切到销售",
|
|
102
|
+
"trigger": "click",
|
|
103
|
+
"conditionType": "all",
|
|
104
|
+
"conditions": [],
|
|
105
|
+
"reverse": false,
|
|
106
|
+
"actions": [
|
|
107
|
+
{
|
|
108
|
+
"id": "action_to_sales",
|
|
109
|
+
"name": "动作",
|
|
110
|
+
"action": "switchState",
|
|
111
|
+
"actionData": {},
|
|
112
|
+
"component": ["$panel(panel_12)"],
|
|
113
|
+
"stateId": "$state(88002)",
|
|
114
|
+
"componentScope": "current",
|
|
115
|
+
"componentConfig": {},
|
|
116
|
+
"unmount": true,
|
|
117
|
+
"agentType": "ai_agent",
|
|
118
|
+
"animation": { "type": "opacity", "timingFunction": "linear", "duration": 1000, "delay": 0 },
|
|
119
|
+
"translate": { "toX": 0, "toY": 0 },
|
|
120
|
+
"scale": { "x": 1, "y": 1, "origin": "50% 50%", "lock": true }
|
|
121
|
+
}
|
|
122
|
+
]
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
`animation.type` 用 `none`、`opacity`、`moveLeft`、`moveRight`、`moveTop`、`moveBottom`、`flipVertical`、`flipLateral`、`boxFlipTB`、`boxFlipLF`。
|
|
128
|
+
|
|
129
|
+
选项卡控制多个状态时,一个选项一条事件。源组件用 `tabV2` 时,`trigger` 以 `component schema tabV2` 的 `triggers` 为准;已有大屏里选中变化是 `stateChange`。条件用数据字段 `content`,`expected` 写成该选项的文案。N 个状态写 N 条 `addComponentEvent`,放进同一次 `apply`。
|
|
130
|
+
|
|
131
|
+
不知道该切哪一个状态、只知道序号时,用 `setIndex`。`component` 仍是 `["$panel(panel_12)"]`,`stateId` 留空,`actionDataFn` 写 `"return 2;"` 表示第二个状态。
|
|
132
|
+
|
|
133
|
+
配完在源组件上 `easyv-screen debug <screenId> <key>`,看 `outgoing` 里有没有这条 `switchState`,以及 `refs` 里面板和 `$state(...)` 的 `found` 是否为 true。
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
# 动态面板、组件容器、数据容器
|
|
2
|
+
|
|
3
|
+
这几类是编辑器里的大屏对象。`document get` 能读到动态面板、引用面板、组件容器,以及根屏上的过滤器和数据容器。
|
|
4
|
+
|
|
5
|
+
## 从零搭建和后来修改
|
|
6
|
+
|
|
7
|
+
从零搭建时,把动态面板、组件容器、过滤器、数据容器写进同一份文档,一次 `document put`。动态面板和组件容器的 `states` 留空数组,服务端各生成一个空状态。过滤器和数据容器写在文档根上的 `filters`、`dataContainers`。不要逐个调用下面的创建命令。
|
|
8
|
+
|
|
9
|
+
改已经存在的大屏时,用单个命令做新增、改名称或位置、删除。这些修改不走 `apply`,也不要为了改一个名称去重写整份文档。
|
|
10
|
+
|
|
11
|
+
| 命令 | 作用 |
|
|
12
|
+
| --- | --- |
|
|
13
|
+
| `panel list/get/create/update/delete <screenId>` | 动态面板。`create` 要 `--key`,可选 `--name`、`--left`、`--top`、`--width`、`--height`、`--parent`、`--index` |
|
|
14
|
+
| `panel state list/get/create/update/delete <screenId> <panelKey>` | 动态面板状态。`create` 可选 `--name`,`update` 要 `--name`。至少保留一个状态 |
|
|
15
|
+
| `container list/get/create/update/delete <screenId>` | 组件容器。字段同 `panel`,名称最长 50 |
|
|
16
|
+
| `filter list/get/create/update/delete <screenId>` | 过滤器。`create` 要 `--key`、`--name`,可选 `--content`、`--callback-keys` |
|
|
17
|
+
| `data-container list/get/create/update/delete <screenId>` | 数据容器。`create` 要 `--key`、`--name`。只改名称 |
|
|
18
|
+
|
|
19
|
+
`document put` 和一次 `apply` 里仍然可以用 `addPanel`、`addContainer`、`addFilter`、`addDataContainer` 新建。这四条操作不能改、也不能删已有对象。
|
|
20
|
+
|
|
21
|
+
`key` 用稳定的名字,例如 `panel-tabs`,会保留。`parent` 只能是已有分组。引用面板和万能组件不能新建。
|
|
22
|
+
|
|
23
|
+
删除动态面板和组件容器会进回收站。过滤器和数据容器会删掉,并解开已有引用。不能把组件放进面板或容器,也不能改状态里面的组件。`element.bindContainer`、`element.bindFilter` 不要调用。
|
|
24
|
+
|
|
25
|
+
`document put` 必须保留读到的面板、容器、过滤器和数据容器。少一个、改内部、或往状态里加减组件,都会整单返回 `UNSUPPORTED_CHANGE`,不落库。新建时 `states` 可以是空数组;已经读到的 `states` 要原样保留。
|
|
26
|
+
|
|
27
|
+
建完重新 `document get`。自定义事件用元素上的 `id` 和 `states[].screenId`,不要用自定义 key 去拼 `$panel`。状态 key 是 `s-` 加子屏 id,`panel state` 用这个 key。
|
|
28
|
+
|
|
29
|
+
## 文档里怎么认
|
|
30
|
+
|
|
31
|
+
`elements` 的 `kind`:
|
|
32
|
+
|
|
33
|
+
| kind | 对象 |
|
|
34
|
+
| --- | --- |
|
|
35
|
+
| `component` | 组件 |
|
|
36
|
+
| `panel` | 动态面板或引用面板 |
|
|
37
|
+
| `container` | 组件容器 |
|
|
38
|
+
|
|
39
|
+
图层 key 由图层 id 换算。元素表里的 key 以 `document get` 返回的为准。
|
|
40
|
+
|
|
41
|
+
| 对象 | 图层 id | 图层 key | 元素 key |
|
|
42
|
+
| --- | --- | --- | --- |
|
|
43
|
+
| 动态面板 | `panel_<id>` | `p-<id>` | `p-<id>` |
|
|
44
|
+
| 引用面板 | `ref_<id>` | `rp-<id>` | `p-<id>` |
|
|
45
|
+
| 组件容器 | `container_<id>` | `k-<id>` | `k-<id>` |
|
|
46
|
+
| 万能组件 | `super_<id>` | `u-<id>` | `u-<id>` |
|
|
47
|
+
| 分组 | `group_...` | `g-...` | 分组不进 `elements` |
|
|
48
|
+
|
|
49
|
+
引用面板和动态面板都放在 `elements["p-<面板 id>"]`。引用面板只在图层上用 `rp-`。按事件里的 `$panel(ref_<id>)` 找元素时,去掉 `ref_` 后到 `p-` 下找。
|
|
50
|
+
|
|
51
|
+
面板和容器的元素上只有 `name`、`layout`(`left` `top` `width` `height`)和 `states`。编辑器里的滚动、默认隐藏、自动布局不在这份文档里。
|
|
52
|
+
|
|
53
|
+
每个状态是一块子屏:
|
|
54
|
+
|
|
55
|
+
```json
|
|
56
|
+
{
|
|
57
|
+
"key": "s-88001",
|
|
58
|
+
"name": "状态1",
|
|
59
|
+
"screenId": 88001,
|
|
60
|
+
"layers": [],
|
|
61
|
+
"elements": {}
|
|
62
|
+
}
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
`key` 是 `s-` 加子屏 id。状态里再嵌一套 `layers` 和 `elements`,组件、面板、容器可以继续往下嵌。读取最多展开 3 层。
|
|
66
|
+
|
|
67
|
+
引用面板和动态面板在元素表里都是 `kind: "panel"`。引用面板的图层 id 以 `ref_` 开头,动态面板以 `panel_` 开头。动态面板新建时自带一个名为「状态1」的子屏。引用面板的状态是它引用的其他大屏。
|
|
68
|
+
|
|
69
|
+
组件容器同样用 `states` 装子屏。万能组件是放进组件容器的子组件。读取时,已经挂在父组件上的万能组件实例不会再展开成一层 `container`,图层上仍是 `super_` / `u-`。
|
|
70
|
+
|
|
71
|
+
`addComponent` 和 `moveLayer` 的 `parentKey` 只能是已有分组(`g-` 开头)。传到 `p-`、`rp-`、`k-` 或状态 key 上会被拒绝。操作只认大屏根上 `elements` 里的组件。状态里的组件不在这张表里,`setComponentConfig` 等操作找不到它们。
|
|
72
|
+
|
|
73
|
+
## 动态面板
|
|
74
|
+
|
|
75
|
+
同一块区域里有多份状态,同一时间显示其中一个。用来做页签内容、弹层、下钻后的另一屏内容。选项卡组件 `tabV2` 只渲染选项本身,不包含这些状态。
|
|
76
|
+
|
|
77
|
+
根上组件可以用自定义事件切到已有面板的某个状态。动作是 `switchState`,目标写成:
|
|
78
|
+
|
|
79
|
+
| 对象 | 引用 |
|
|
80
|
+
| --- | --- |
|
|
81
|
+
| 动态面板 | `$panel(panel_<id>)` |
|
|
82
|
+
| 引用面板 | `$panel(ref_<id>)` |
|
|
83
|
+
| 面板状态 | `$state(<子屏 id>)` |
|
|
84
|
+
|
|
85
|
+
子屏 id 是状态的 `screenId`。事件写在源组件上,字段和示例见 [custom-events.md](custom-events.md)。
|
|
86
|
+
|
|
87
|
+
## 组件容器
|
|
88
|
+
|
|
89
|
+
一块可放组件的区域,容器自己取数,再按数据行把内部组件重复排出来。编辑容器内部时只用第一条数据;预览和发布时用全部行,按容器的自动布局排成行或列,放不下时可以滚动。
|
|
90
|
+
|
|
91
|
+
容器有两种数据来源:
|
|
92
|
+
|
|
93
|
+
- 容器自己的数据源或静态数据。
|
|
94
|
+
- 绑定的数据容器。编辑器里 `dataFrom` 为 `1` 时用数据容器;为 `0` 时用容器自己的数据。绑了一个数据容器时用那一份结果,绑了多个时结果是数组。容器还可以再套过滤器。
|
|
95
|
+
|
|
96
|
+
子组件的数据类型为 `fromContainer` 时,用容器按组件标识分下来的字段,不再自己请求。数据类型为 `fromUniversal` 时,用万能组件分下来的数据。
|
|
97
|
+
|
|
98
|
+
文档里只能看到容器的位置、状态和状态里的组件,看不到自动布局、组件标识和 `dataFrom`。这些要改时到编辑器里做。
|
|
99
|
+
|
|
100
|
+
容器内组件在事件里的引用是 `$container_<容器 id>(component(<组件 id>))`。容器本身是 `$container(container_<id>)`。万能子组件是 `$super(component(<组件 id>))`。
|
|
101
|
+
|
|
102
|
+
## 数据容器
|
|
103
|
+
|
|
104
|
+
数据容器挂在大屏上,不占图层。它自己取数、过滤,组件、组件容器和万能组件再绑定它,用它的结果代替自己取数。一个组件可以绑多个。组件 `dataFrom` 为 `1` 时才改用数据容器,为 `0` 时仍用组件自己的静态数据或数据源。
|
|
105
|
+
|
|
106
|
+
`document get` 在有数据容器或过滤器时返回 `dataContainers`、`filters`,字段是 `id` 和 `name`,过滤器还有 `content`。没有则省略。从零搭建时写进文档。改已有大屏时用 `data-container` 和 `filter` 新建、修改或删除。`element.bindContainer` 和 `element.bindFilter` 在操作词表里 `available` 为 false,不要调用。
|
|
107
|
+
|
|
108
|
+
组件自己的数据源继续用 `element.bindData`,静态数据用 `setComponentStaticData`。这两条都不是数据容器。
|
|
109
|
+
|
|
110
|
+
## 排查时怎么看
|
|
111
|
+
|
|
112
|
+
- 组件在面板或容器的某个状态里时,`debug` 的 `location` 有 `parentKey`、`parentKind`(`panel` 或 `container`)、`stateKey`、`stateName`。没有 `location` 就是在大屏根上。
|
|
113
|
+
- `refs` 会把 `$panel`、`$container`、`$state`、`$super` 解析成文档 key。`found` 为 false 表示文档里没有这个对象。
|
|
114
|
+
- 组件 `dataBinding` 为 null、静态数据也对不上画面时,数据可能来自数据容器,或来自组件容器 / 万能组件下发。文档里看不出这层绑定,直接告诉用户。
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: figma-asset-slice
|
|
3
|
-
description: 用于从 Figma 大屏设计稿中导出适配 EasyV 的可复用资产,整合切图与组装规律、Figma 导出限制、EasyV 组件补位及 Fable 5.2
|
|
3
|
+
description: 用于从 Figma 大屏设计稿中导出适配 EasyV 的可复用资产,整合切图与组装规律、Figma 导出限制、EasyV 组件补位及 Fable 5.2 产物中的可借鉴规则。还原到 EasyV 时,切完按 easyv-screen-build 的「从 Figma 设计稿还原」继续:先在本地用 React 和 Vite 核对,再上传组件并搭建大屏。
|
|
4
4
|
---
|
|
5
5
|
# figma-asset-slice
|
|
6
6
|
|
|
@@ -158,6 +158,8 @@ description: 用于从 Figma 大屏设计稿中导出适配 EasyV 的可复用
|
|
|
158
158
|
|
|
159
159
|
## 切完之后
|
|
160
160
|
|
|
161
|
+
还原到 EasyV 时,这一步只提供素材和清单。下一步在本地用 React 和 Vite 按清单搭出画面并核对组件拆分,确认后再上传。流程见 [easyv-screen-build](../easyv-screen-build/SKILL.md) 的「从 Figma 设计稿还原」。
|
|
162
|
+
|
|
161
163
|
- 清单里记录:类型、来源节点、格式与导出倍率、布局框、导出尺寸、四边溢出、去掉的背景模糊半径;多尺寸标本注明布局档位(1x / 1.5x / 2x …)和该档宽高。这份清单是给后续对齐和组装用的机器可读记录,不是要上传的素材本身。
|
|
162
164
|
- 独有项去向与重复引用、独立装饰的关系/对齐/复用、单格用途/间距/拼装及固定整组例外、整壳与标题的互斥替代方案、内嵌位图的尺寸/清晰度依据/处理与前后体积,写入清单中明确可展示的 `specialJudgments` 或 `notes`。不要求改预览脚本或强制引入新 schema;不得只有生成者脑中知道的装配约定。
|
|
163
165
|
- 图表区域和进度条留给图表组件,不要用切图去贴。
|