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

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

选择阅读入口

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