樣式設定參考

設定元素的外觀和行為。

樣式設定 標籤頁是您自訂目前選取元素屬性的地方。可用選項會根據選取的元素類型（文字、圖片、條碼等）而不同。

通用版面配置屬性

所有元素共享一組基本的版面配置控制項：

  • X / Y：元素的座標，以毫米為單位。
  • 定位模式：
    • 絕對：固定座標（X、Y），相對於頁面原點。
    • 相對：自動將元素定位在圖層清單中 前一個 元素的下方。適用於會擴展的動態內容。
  • 寬度 / 高度：元素的尺寸，以毫米為單位。
    • 0 = 自動：大多數元素在設為 0 時會自動擴展以適應其內容。

條件可見性

元素支援 visible 屬性（可透過 YAML 設定），可根據資料值條件式地顯示或隱藏元素。當條件評估為 false 時，該元素在 PDF 生成期間會被完全略過。

範例（在範本 YAML 中）：

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

元素專屬設定

文字元素

文字元素支援動態調整大小和溢出處理。

  • 自動調整大小（寬度/高度 = 0）：

    • 如果寬度和高度均為 0，文字方塊會自動水平和垂直擴展以適應內容（無限制）。

  • 固定尺寸：

    • 如果您設定特定的 寬度，文字會在該寬度內換行。
    • 如果您設定特定的 高度，您可以控制溢出行為。
    • 溢出：
      • 可見：超出方塊的內容保持可見。
      • 裁切：超過尺寸的內容會被隱藏。

  • 行高：控制文字行間的垂直間距。以倍率指定（例如 1.2 = 字型大小的 120%）。

圖片元素

  • 來源：選擇圖片時，它會自動複製到設定檔工作區中的 assets 資料夾。
  • 適應：控制圖片在方塊內的縮放方式（Contain、Cover、Fill）。
  • 透明度：控制圖片的透明度（0–100%）。

條碼元素

生成標準 1D 條碼。

  • 類型：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 之間切換以最佳化條碼長度。您不需要手動指定子集。

QR Code 元素

生成 2D QR Code。

  • 顏色：設定 QR Code 模組的前景色。
  • 背景色：設定 QR Code 後方的背景色。
  • 透明度：控制 QR Code 的透明度（0–100%）。
  • 安靜區：
    • 預設會套用標準的 4 模組邊距。
    • 取消勾選 使用安靜區 可將邊距設為零（滿版出血）。

靜態表格

具有固定列數和欄數的表格，可手動編輯。

  • 欄：定義欄數及其標題。
  • 列：手動新增或移除列。
  • 內容類型：儲存格可包含 文字、條碼 或 QR Code。
  • 最小列數：
    • 確保表格至少顯示 N 列。
    • 如果手動資料少於 N 列，會新增空白占位列以填滿空間。

分組表格（交易資料）

動態表格，會遍歷與 分組鍵 關聯的交易資料。

  • 分組鍵：定義哪些交易記錄為此表格分組在一起。
  • 內容類型：儲存格支援 文字、條碼 和 QR Code。
  • 最小列數：
    • 確保表格至少顯示 N 列，如果交易資料少於 N 列則新增空白行。
    • 即使資料量不同，也能維持一致的版面配置高度。
  • 分頁：
    • 如果列數超過頁面高度（由邊界定義），表格會自動中斷並在 下一頁 繼續。
  • 合計與頁尾：
    • 分組表格沒有內建的合計頁尾列。
    • 解決方案：為合計建立獨立的 文字 或 靜態表格 元素，並將其放置在圖層清單中分組表格的 下方。將其定位模式設為 相對。
    • 間距控制：在 相對 模式下，Y 屬性允許您設定分組表格底部與此頁尾元素頂部之間的垂直間距（以 mm 為單位）。