骑缝章 seal
约 762 字大约 3 分钟
...
2026-09-28
插件说明
@sv-print/plugin-ele-seal 骑缝章打印元素插件：设计态展示完整章图（含 5 等分辅助虚线）；打印/预览时本体不渲染，由 beforeGetHtml hook（异步，接收 printData）在分页完成后按实际渲染页数把章图切分为等宽条，逐页在纸边显示对应部分，拼合可还原完整章图。
无第三方依赖。
npm install @sv-print/plugin-ele-seal示例代码
import pluginEleSeal from '@sv-print/plugin-ele-seal';
const plugins = [pluginEleSeal()];
await hiprint.register({ plugins }); // 须在创建模板/打开设计器之前注册后设计器左侧「插件」分组出现「骑缝章」元素，拖入模板即可；属性面板含「基础 / 骑缝」两个页签。
图源按以下优先级解析：
field：打印数据字段（支持a.b点路径取值），多份打印（printData 为数组）时取首个命中项src：元素上直接配置的图片地址（URL / base64 / dataURI）
两者均无值时静默跳过（不注入任何章条），不影响单据正常渲染。
高级用法
骑缝参数
| 参数 | 说明 | 默认值 |
|---|---|---|
sealSide | 章条位置：right 右缝（首页取最右条）/ left 左缝（镜像） | right |
sliceMode | 切分方式：avg 均分（条宽=章宽/页数）/ fixedWidth 固定露边宽 | avg |
sliceWidth | fixedWidth 模式下每页露边宽度（pt） | 25 |
floatMode | 上下浮动：none / wave 波浪 / drift 渐变 / random 随机 | none |
floatAmplitude | 最大浮动距离（pt） | 10 |
floatDirection | 浮动方向：up2down 从上往下 / down2up 从下往上 | up2down |
sealSeed | 随机/波浪种子，留空自动生成；相同种子多次渲染结果一致 | 自动 |
rotate | 章图旋转：0 / 90 / 180 / 270（度） | 0 |
opacity | 章条透明度 0~1（淡章） | 1 |
pageRange | 盖章页范围（见下表） | all |
「基础」页签复用内核通用属性：title / field / src / testData / coordinate / widthHeight / showInPage / unShowInPage / fixed。
pageRange 盖章页范围
按「份」解析（页码为每份内部的页序，1-based）：
| 写法 | 含义 |
|---|---|
all 或留空 | 每一页都盖 |
first:3 | 前 3 页（超过总页数取 min） |
1-3,5 | 第 1~3 页与第 5 页，逗号分隔、去重排序、越界忽略 |
odd / even | 奇数页 / 偶数页 |
1-3,odd | 关键字可与数字/区间混写，自动去重 |
解析失败（空集合/非法值）自动回退 all。多份打印（printData 为数组且页数可整除）按份独立骑缝。
版权所有
版权归属：sv-print