样式设置

配置元素的外观和行为。

样式 选项卡用于自定义当前选中元素的属性。可用选项因所选元素的类型（文本、图像、条码等）而异。

通用布局属性

所有元素共享一组基本布局控制项：

  • X / Y：元素的坐标（毫米单位）。
  • 定位模式：
    • 绝对定位：相对于页面原点的固定坐标（X、Y）。
    • 相对定位：自动将元素定位在图层列表中 前一个 元素的下方。适用于会扩展的动态内容。
  • 宽度 / 高度：元素的尺寸（毫米单位）。
    • 0 = 自动：设为 0 时，大多数元素会自动扩展以适应内容。

条件可见性

元素支持 visible 属性（可通过 YAML 配置），根据数据值条件性地显示或隐藏元素。当条件计算为 false 时，PDF 生成过程中将完全跳过该元素。

示例（模板 YAML 中）：

visible: "{{Status}} == 'PAID'"

元素特定设置

文本元素

文本元素支持动态调整大小和溢出处理。

  • 自动调整大小（宽度/高度 = 0）：

    • 当宽度和高度都为 0 时，文本框会自动在水平和垂直方向扩展以适应内容（无限制）。

  • 固定尺寸：

    • 设置特定 宽度 后，文本将在该宽度内换行。
    • 设置特定 高度 后，可以控制溢出行为。
    • 溢出：
      • 可见：超出框体的内容仍然可见。
      • 裁剪：超出尺寸的内容将被隐藏。

  • 行高：控制文本行间的垂直间距。以倍数指定（例如 1.2 = 字体大小的 120%）。

图像元素

  • 来源：选择图像时，会自动复制到配置文件工作区内的 assets 文件夹。
  • 适应：控制图像在框内的缩放方式（包含、覆盖、填充）。
  • 不透明度：控制图像的透明度（0–100%）。

条码元素

生成标准一维条码。

  • 类型：CODE128、JAN、EAN13、EAN8、CODE39、UPCA、NW-7、ITF
  • JAN/EAN：
    • 支持 13 位或 8 位编码。
    • 为 JAN/EAN13 输入 12 位 数字时，引擎会自动计算并附加 校验位。
  • CODE39：
  • NW-7 (Codabar)：
    • 与 CODE39 类似，需要在输入数据中包含起止字符（A、B、C 或 D）（例如 A12345678A）。
  • CODE128：
    • 自动在子集 A、B 和 C 之间切换以优化条码长度。无需手动指定子集。

二维码元素

生成二维码。

  • 颜色：设置二维码模块的前景色。
  • 背景色：设置二维码背后的背景色。
  • 不透明度：控制二维码的透明度（0–100%）。
  • 静区：
    • 默认应用标准的 4 模块边距。
    • 取消勾选 使用静区 可将边距设为零（全出血）。

静态表格

具有固定行数和列数的手动编辑表格。

  • 列：定义列数及其表头。
  • 行：手动添加或删除行。
  • 内容类型：单元格可包含 文本、条码 或 二维码。
  • 最小行数：
    • 确保表格始终至少显示 N 行。
    • 如果手动数据少于 N 行，则添加空的占位行来填充空间。

分组表格（交易数据）

遍历与 分组键 关联的交易数据的动态表格。

  • 分组键：定义将哪些交易记录分组到此表格中。
  • 内容类型：单元格中支持 文本、条码 和 二维码。
  • 最小行数：
    • 确保表格始终至少显示 N 行，如果交易数据少于 N 行则添加空行。
    • 适用于在数据量可变的情况下保持一致的布局高度。
  • 分页：
    • 如果行数超过页面高度（由边距定义），表格会自动分割并在 下一页 继续。
  • 合计与页脚：
    • 分组表格没有内置的合计页脚行。
    • 解决方案：为合计创建单独的 文本 或 静态表格 元素，并在图层列表中将其放在分组表格的 下方。将定位模式设为 相对定位。
    • 间距控制：在 相对定位 模式下，Y 属性可设置分组表格底部与页脚元素顶部之间的垂直间距（毫米单位）。