JavaScript is required

自定义视图与背景(#view / #background

本页说明视图层定制,并同时覆盖背景与画布前景的使用策略。

1. 视图插槽(#view

视图插槽用于“相对视口固定”的 UI。

写法:

  • Vue:#view
  • React:<RGSlotOnView>
  • Svelte:slot="view"

特性:

  • 不随画布平移/缩放
  • 适合浮动工具栏、面板、菜单、提示层

2. 画布前景插槽(#canvas-above

canvas-abovecanvas 类似,但渲染层级在节点/连线之上。

适合“跟随画布坐标,同时要始终显示在图元之上”的内容。

3. 背景插槽(#background

背景插槽位于画布底层。

特性:

  • 不随画布平移/缩放
  • 适合水印、主题底纹
  • 可在导出图片时作为背景参与渲染

4. 推荐组合方式

  1. background:全局背景/水印
  2. canvas:坐标系内底层附加图元
  3. canvas-above:坐标系内上层覆盖
  4. view:视口固定交互组件

5. 示例(Vue 概念)

<template #background>
  <div class="my-bg"></div>
</template>

<template #view>
  <MyFloatingToolbar />
</template>

6. 实践建议

  • RGToolBarRGMiniView、编辑控制器优先放在 view 层。
  • 品牌背景/水印优先放在 background 层。
  • 明确区分“视口固定 UI”和“画布坐标 UI”。

7. 下一步阅读