### hiprint框架中页码格式设置方法 在 `hiprint` 框架中，可以通过 `paperNumberFormat` 属性来定义打印页面中的页码显示样式。以下是关于该属性的具体说明以及如何使用的详细描述。 #### 1. 基本概念 `paperNumberFormat` 是用于指定页码展示格式的一个字符串模板[^1]。它支持动态变量替换功能，允许开发者自定义页码的呈现方式。通过此属性可以灵活控制页码的文字表述形式及其布局。 #### 2. 动态变量解释 在 `paperNumberFormat` 中可使用两个内置占位符： - **`{paperNo}`**: 表示当前页号。 - **`{paperCount}`**: 表示总页数。 这些占位符会被实际数值替代，在最终渲染时形成完整的页码文字[^1]。 #### 3. 配置实例 下面是一个具体的例子展示了怎样利用 `paperNumberFormat` 来定制不同的页码风格： ```javascript // 初始化打印模板对象 var hiprintTemplate = new hiprint.PrintTemplate(); // 添加一个新的打印面板并设定其参数 var panel = hiprintTemplate.addPrintPanel({ width: 210, height: 297, paperFooter: 807, // 定义页脚距离顶部的距离 paperHeader: 30, // 定义页眉距离顶部的距离 paperNumberFormat: "{paperNo}/{paperCount}", // 自定义页码格式为 "当前页/总页" paperNumberLeft: 300 // 设定页码水平方向上的偏移量 }); // 向面板添加长文本内容项 panel.addPrintLongText({ options: { width: 500, height: 297, top: 50, left: 50, title: 'Example Title', hideTitle: true, fontFamily: 'Arial', fontSize: 12, fontWeight: 'normal' } }); ``` 在此代码片段里，我们设置了 `{paperNo}/{paperCount}` 的模式作为默认样式的页码表示法。这意味着如果文档有三页，则每一页底部会分别显示出 “1/3”, “2/3” 和 “3/3”。 #### 4. 更改页码位置 除了调整格式外，还可以改变页码的位置。这主要依赖于 `paperNumberLeft` 参数来进行横向定位。例如将其值设为更小或者更大的数字即可实现向左或右移动的效果[^1]。 --- ### 注意事项 虽然上述介绍了基本应用技巧，但在某些复杂场景下可能还需要考虑其他因素比如国际化需求等。因此建议深入查阅官方API文档获取更多高级特性支持的信息。