Gander里的Word为何能像电脑一样分页?w:lastRenderedPageBreak分页与夜间模式实现揭秘

原创2026-10-14 16:20:451,393 阅读

Gander里的Word为何能像电脑一样分页?w:lastRenderedPageBreak分页与夜间模式实现揭秘

Gander 是一款离线、零权限的 Android 文件查看器,如今打开 Word(.docx)文件时,能像在电脑上一样的按页分页显示,还能一键切换夜间模式。秘密在于它直接读取了 Word 保存文件时留下的 w:lastRenderedPageBreak 分页记录,并对没有记录的页面做了智能补齐;夜间模式则用逐色反转矩阵代替整体滤镜,保证彩色不失真。本文带你揭开这套机制的实现细节。

Gander 离线文件查看器支持 Word 分页与夜间模式

为什么 Word 在手机上会变成一整长页?

Word 文件本质上没有"页"的概念——它是一股连续的文字流,分页是排版引擎在打开文件时临时算出来的。而 Gander 用的 docx-preview 这个开源库,只在遇到手动分页符或分节符时才开始新的一页,所以一篇没有任何手动分页的文档,在手机上就会变成一长条"纸",既没有页码,也没法跳到第几页。

Gander 的解法不是"重算排版",而是"抄 Word 的作业":利用 Word 自己留下的分页痕迹。

关键机制:读取 w:lastRenderedPageBreak 分页记录

当你用 Word 编辑并保存文件时,Word 会把上一次排版结果中每一页从哪里开始记录下来,写在文档 XML 里,对应的标记就是 w:lastRenderedPageBreak(最后一次渲染时的分页)。

Gander 在 docx-pages.js 中先检查文档里是否带有这种标记:

function vwIsPageMark(node) {
  return node.type === "break" && node.break === "lastRenderedPageBreak";
}

一旦发现存在,就会接管 docx-preview 的分页逻辑(splitBySection、groupByPageBreaks 等,见 docx-pages.js#L98-L162),把正文按照这些标记切成一页一页,每页渲染成一张独立的"纸"。核心切分函数 splitPieces(docx-pages.js#L230-L370)还处理了各种细节:

  • 硬分页符(w:br type="page")始终分页,哪怕页面上还没有内容;
  • 记录重复时不会多切出空白页;
  • 分节符会继承前一节的页眉页脚引用(vwInheritRefs),避免页码丢失;
  • 多栏排版中的分页记录会被剔除,因为"栏"的分栏位置容易被误认成换页。

切页完成后,vwNumberPages(docx-pages.js#L480-L510)会把正确的页码写回页脚里的 PAGE、NUMPAGES 等域,支持阿拉伯数字、罗马数字、字母等多种格式,和 Word 的计数规则一致。

Gander 在平板上阅读 Word 文档并显示当前页码

一个重要的兼容性细节:WPS、LibreOffice、Google Docs 保存的文件不写 w:lastRenderedPageBreak,Gander 会自动回退到原来的长页渲染方式,不会硬切(docx-pages.js#L107-L116)。

智能补页:找出 Word 没记录的空行分页

w:lastRenderedPageBreak 有一个盲区:如果某一页是以空行或空表格行开头的,Word 不会留下记录。这样按记录切出来的页数,就会少于 Word 自己声称的页数。

Gander 的做法很巧妙:Word 保存文件时会把总页数写进 docProps/app.xml(vwPages.wordPages),用它减去当前切出的页数,就知道少了多少页。然后:

  1. vwMeasureSheet(docx-pages.js#L453-L473)量出每页的实际高度、纸张可用空间,以及"可以分页"的位置(通常是空段落);
  2. vwPlaceTurns 反复挑选溢出纸张最严重的那一页,在其内部最接近等分点、且上半页至少填满一半的位置插入分页(模拟 Word "写满了才换页"的习惯);
  3. 得到补页方案 turnAt 后,整篇文档重新渲染一次,缺失的页就补全了。

这个流程由 docx.js 在首次渲染后触发:发现缺页 → 二次绘制 → 校验页数。

像纸一样的页面:宽度自适应与行距还原

分页只是第一步,要让每页"看起来就是 Word 里那样",Gander 还做了两件事:

页面填满屏幕宽度。 docx-preview 按真实纸张宽度渲染(Letter 纸约 816 CSS px),而 WebView 布局宽度固定为 980px。fitPageWidth(docx.js#L119-L140)量出最宽一页(而非第一页,以兼容横纵混合的文档)并计算缩放比,通过 CSS 变量 --vw-page-zoom 让页面放大到 docx.html#L70-L75 定义的 zoom 上——用 zoom 而非 transform: scale,保证滚动高度等测量不受影响。

行距与字体还原。 手机上没有 Word 的字体,<a href="https://link.gitcode.com/i/d52c57ed42578f566b6df0c039e2ea95" target="_blank">docx-lines.js</a> 内置了一张 Word 常见字体的度量表(单行高度、字号换算系数),用 Android 自带字体配合 CSS size-adjust 把文字"调宽"到和 Word 里一样宽,再按 Word 的规则计算每行高度;w:contextualSpacing(列表段落的段间距开关)等细节也从 styles XML 里读出补齐。这样每一页装下的文字量就逼近 Word 的排版结果——上面"智能补页"才因此更准。

Word 夜间模式实现:逐色反转而非整体滤镜

夜间模式的直觉做法是给页面套一个 invert(1) 滤镜,但 Gander 的 docx-night.js 刻意不用页面级滤镜:照片里的天空、肤色会被一起反色,观感很糟。它的方案是:

  • 颜色矩阵换色:VW_NIGHT_MATRIX(docx-night.js#L17-L21)就是 PDF 夜间模式所用的 invert(1) hue-rotate(180deg) 的展开形式。每个元素上的 color、background-color、边框色等,都会被逐色换算(墨色变亮、蓝色标题保持蓝色),结果写进自定义属性,只在 html.vw-night 下生效;
  • 区分"纸"与"照片":vwLooksLikePaper(docx-night.js#L150-L167)把图片缩到 64px 宽,统计亮度与饱和度——白底插图(data 图、表格截图)会随页面一起反色,真实照片保持原样(docx.html#L134);
  • 只为屏幕服务:夜间样式全部包在 @media screen 里,打印时仍用文档原本的配色;关掉夜间模式就是摘掉一个 CSS class,零成本。

Gander 夜间模式下阅读文档,页面变黑文字变亮

应用与网页之间的分页通信

Kotlin 侧和 WebView 之间没有用 addJavascriptInterface,而是走一条 HTML5 消息通道,只传字符串、不执行任何 JS,这也是 Gander 零权限安全模型的一部分(见 PortMessage.kt 的文件头注释)。命令只有一个字母的动词:

命令 含义
g3 跳到第 3 页(PortCommand.goToPage)
i1 / i0 开 / 关夜间模式(PortCommand.nightMode)
page 3 10 网页回传:屏幕中部在第 3 页,共 10 页

网页侧由 vwPageCommand(docx.js#L142-L147)接收,滚动时用二分查找算出屏幕中部的页码并上报(docx-pages.js#L567-L587),于是 Word 文档也拥有了和 PDF 一样的"页码指示器 + 跳转页面"体验。

Gander 零权限离线查看 Word PDF 等文档,无需联网

源码导航:相关文件清单

想动手看看实现,建议按这个顺序阅读:

总结一下:Gander 让 Word 在手机上"像电脑一样分页",靠的不是重新发明排版引擎,而是读懂 Word 自己留下的 w:lastRenderedPageBreak 记录、用 Word 声称的总页数补齐遗漏,再用字体度量表还原行距,最后用逐色反转矩阵做出不失真的夜间模式——小而精,正是 Gander 的工程师风格。🦢

登录后查看全文
gander