元素设置
在模板设计器中管理元素和图层。
元素 选项卡是管理模板结构的控制中心。在这里,您可以向画布添加新的视觉组件并管理现有元素的堆叠顺序(图层)。
管理与配置的区别
元素选项卡 仅用于元素的 添加、排序和删除。 要配置位置、字体、内容或尺寸等属性,请使用 样式设置 选项卡。
添加元素
要向模板添加组件,只需点击"添加元素"网格中的按钮。新元素将出现在画布上,并添加到 图层 列表的顶部。
| 元素类型 | 说明 |
|---|---|
| 文本 | 标准文本块。可以是静态文本或映射到数据的变量。 |
| 图像 | 静态图像(例如徽标、签名)。 |
| 条码 | 从数据生成条码(Code39、Code128 等)。 |
| 二维码 | 从数据生成二维码。 |
| 静态表格 | 用于表头或信息框等布局的固定网格。 |
| 分组表格 | 遍历交易数据的动态表格。 |
其他元素类型
Rect(矩形)和 Line(线条)元素也受支持,但只能通过直接编辑模板 YAML 文件来添加。无法通过设计器 UI 按钮添加。
图层面板与 Z 轴顺序
选项卡底部的 图层 列表显示当前页面上的所有元素。此列表的顺序决定了 绘制顺序(Z-Index) 和相对定位的 流动顺序。
图层管理
- 选择:点击图层以选择该元素。
- 排序:
- 上箭头 (↑):将元素在列表中上移(视觉效果:移向背面)。
- 下箭头 (↓):将元素在列表中下移(视觉效果:移向前面)。
- 删除:点击 垃圾箱 图标删除元素。
理解 Z 轴顺序(堆叠)
列表中元素的顺序决定其堆叠顺序(z-index)。
- 列表顶部 = 最先绘制(背景)
- 列表底部 = 最后绘制(前景)
如果两个元素重叠(例如文本覆盖在图像上),列表中 位置更靠下 的元素会显示在列表中位置更靠上的元素 上方。
案例分析:相对定位与图层顺序
在 样式 选项卡中将元素位置设为 相对定位 时,图层顺序 变得至关重要。
相对定位规则
"相对定位"的元素根据图层列表中 前一个元素 的左下角来定位自身。
示例场景
假设您有两个文本元素:
- "报告标题"(静态文本,大字体)
- "日期"(变量文本,小字体)
您希望 日期 自动出现在 报告标题 的 下方,无论标题有多长。
正确配置
图层顺序:
- 报告标题(列表中第一个)
- 日期(列表中第二个)→ 位置设置:相对定位
结果: 日期 查看紧邻其前面的元素(报告标题),计算标题结束的位置,并将自身定位在其正下方。
错误配置
图层顺序:
- 日期(列表中第一个)→ 位置设置:相对定位
- 报告标题(列表中第二个)
结果: 日期 没有"前一个元素"(或参照页面边距),因此停留在顶部。报告标题 在日期 之后 绘制,可能与其重叠或出现在错误的位置。
最佳实践
构建基于流动的布局(如信函正文)时,请确保图层列表与 阅读顺序(从上到下)一致。