Skip to content

了解接入边界 ​

DragCraft 提供页面编辑能力,不替你的应用定义业务物料、保存接口或生产运行时。接入完成后,你会拥有一个能够编辑 DocumentSchema 的 Vue 工作台,以及一份可以交给服务端和多端 Runtime 消费的页面数据。

这套指南假设你已经会使用 Vue 3、TypeScript 和你选择的 UI 组件库。你不需要了解 DragCraft 的内部 package;先完成 5 分钟跑通 就可以开始。

先看两个可运行结果 ​

仓库中的 guide-project 同时提供最小接入和完整活动页编辑器:

bash
pnpm install
pnpm --filter guide-project dev

打开以下地址:

  • http://localhost:9982/minimal.html:只有一个文本物料,用于确认安装和挂载过程。
  • http://localhost:9982/:包含业务物料、属性配置、容器、设备预览、草稿保存和 Vue 只读运行时。

在最小编辑器中拖入“文本”,选中节点,再修改右侧的“文本内容”。画布更新后,使用工作台撤销这次修改。完整示例可以继续观察设备切换、容器 region、草稿修订和生产 Runtime 的差异。

在完整编辑器中可以观察四种页面结构:

页面内容Schema 表达设计态结果
公告、文本普通节点由宿主内容组件放入可滚动区域
活动页头页面框架物料由 Designer Frame 或宿主展示策略放置在页面边缘
浮动操作业务浮层物料由 Designer Frame 或生产 Runtime 自己决定叠放关系
分栏容器container.regions由业务容器拥有并排列子节点

先划清职责 ​

DragCraft 负责你的应用负责
DocumentSchema、AuthoringAction、history 和导入校验页面记录、草稿修订、发布和审核
物料拖放、选择和属性绑定业务 Vue 组件、资源选择器和内容主题
设计态布局投影和交互反馈生产端的组件注册表与布局解释
字段 adapter 协议和表单状态UI 库、异步选项、权限和服务端校验

IMPORTANT

DcDesigner、DesignerRegionOutlet 和编辑器的 Device Frame 都包含设计态语义。生产页面应读取导出的 Schema,并使用自己的只读 Runtime 渲染。

选择阅读入口 ​

完整的内部设计依据保留在 Architecture Map。公开应用只能直接导入 @dragcraft/designer、@dragcraft/device-frames 和匹配的 @dragcraft/fields-* 字段 adapter;其他 workspace package 由 Designer 组合,不属于业务接入面。