自定义视图与背景(#view / #background)
本页说明视图层定制,并同时覆盖背景与画布前景的使用策略。
1. 视图插槽(#view)
视图插槽用于“相对视口固定”的 UI。
写法:
- Vue:
#view - React:
<RGSlotOnView> - Svelte:
slot="view"
特性:
- 不随画布平移/缩放
- 适合浮动工具栏、面板、菜单、提示层
2. 画布前景插槽(#canvas-above)
canvas-above 与 canvas 类似,但渲染层级在节点/连线之上。
适合“跟随画布坐标,同时要始终显示在图元之上”的内容。
3. 背景插槽(#background)
背景插槽位于画布底层。
特性:
- 不随画布平移/缩放
- 适合水印、主题底纹
- 可在导出图片时作为背景参与渲染
4. 推荐组合方式
background:全局背景/水印canvas:坐标系内底层附加图元canvas-above:坐标系内上层覆盖view:视口固定交互组件
5. 示例(Vue 概念)
<template #background>
<div class="my-bg"></div>
</template>
<template #view>
<MyFloatingToolbar />
</template>
6. 实践建议
RGToolBar、RGMiniView、编辑控制器优先放在view层。- 品牌背景/水印优先放在
background层。 - 明确区分“视口固定 UI”和“画布坐标 UI”。