Skip to content

v0.15.0

Choose a tag to compare

@donglua donglua released this 17 Nov 10:14
· 25 commits to main since this release

发布页面:v0.15.0 Release。

本版本主要新增 XLSX 冻结窗格全端支持(core / Android / HarmonyOS NEXT / macOS)与 DOCX / PPTX 正文划词选区及复制能力(Android / HarmonyOS NEXT),并修复 DOCX 行内图水平对齐、文本框自适应及选区交互手势等细节问题。

排版与特性

  • XLSX 冻结窗格(core / viewer / viewer-ohos / viewer-macos):

    • 核心解析(core):Sheet 新增可选字段 frozenRows / frozenColumns(schemaVersion 保持 9,值为 0 时不参与序列化,旧文档 JSON 结构不变);解析 <sheetViews>/<sheetView>/<pane> 的 state="frozen" 与 state="frozenSplit",支持仅冻结行、仅冻结列与行列交叉冻结,兼容 "2" 与 "2.0" 两种整数写法,冻结值按工作表行列维度安全钳位;非冻结的自由拆分(state="split" 或空 state 带非零拆分)只发告警不生效,非整数拆分向下取整并告警,非法数值返回 Error::Invalid。
    • 三端渲染:Android、HarmonyOS NEXT 与 macOS 均以单画布四象限裁剪绘制实现冻结区与滚动区共存,行列标头分段锁定,冻结交界处绘制 1px #9aa5b1 分割线;跨冻结边界的合并单元格在各象限分别平移裁剪绘制。
    • 视口占比保护:按 X/Y 轴独立判断冻结区是否超过可用正文区的 75%,高倍缩放或小窗口下仅取消超限的那个轴,避免正文被冻结区挤满。
    • 检索高亮与跳转避让:命中高亮按象限裁剪,滚动区高亮不会覆盖冻结区;跳转命中冻结行/列时该轴保持当前滚动位置,命中滚动区时才对齐到可滚动视口中心。
    • macOS 视口修正:.xlsx 分支改为传入真实滚动视口 docVisible,并在 NSScrollView 滚动时触发重绘,修正长表格滚动时连外围行列标头一起滚走的问题。
  • DOCX / PPTX 正文划词选区与复制(viewer / viewer-ohos):

    • 纯逻辑选区模型(双端同构):新增 TextSelectionModel.java(纯 Java 11,零 android.* 依赖)与 TextSelectionModel.ts(纯 TypeScript,零 ArkUI / @kit.* 依赖),语义与 macOS 端 TextSelectionModel.swift 保持一致:块索引 + UTF-16 码元偏移定位、锚点/焦点支持反向拖选、代理对边界夹紧、跨段落与跨块 \n 拼接、命中测试、分词选词、选区高亮矩形与手柄几何计算。core/ 与 schemaVersion 保持 9 不变。
    • 排版几何衔接(Android):新增 AndroidTextLayoutBuilder,把 OfficeRenderer 的 StaticLayout + Matrix 布局结果转换为文档文本索引,直接复用系统排版度量保证“所见即所选”,兼容多字体混排、上下标、字间距与四类对齐;表格按非空文本单元格聚合成独立块(行优先);PPTX 远端未排版页先建纯文本轻量占位块,滚入视口后再懒补行几何,blockIndex 在补全前后严格稳定。
    • 排版几何衔接(HarmonyOS):CanvasElementDrawer 新增 buildParagraphsBlockLines / buildElementTextBlocks / extractElementFullText / CanvasTextLineMetrics,行度量与既有检索高亮共用同一套坐标规则(两端对齐拉伸、字符间距、居中/右对齐偏移、段落 before/after 与元素垂直对齐);普通文本块由 Text/Span 统一为 Canvas 绘制,与绕排图文块排版间距完全一致。
    • 触屏交互:长按默认选词并支持不松手直接滑动扩选,松手展示起止水滴手柄与浮动气泡(「复制」/「全选」),支持拖拽手柄微调(可跨越锚点反向选择)与四边自动滚动;拖拽时对触点纵向补偿避免指腹遮挡。单击空白清除选区,双击缩放与双指捏合、惯性 Fling、单指滚动均不退化。
    • 绘制与无障碍:选区高亮 #551A73E8、光标竖线 2vp 与固定物理尺寸水滴手柄;Android 通过 onInitializeAccessibilityNodeInfo 补充“全选文本 / 复制选中文本 / 清除选区”自定义动作,HarmonyOS 浮动气泡样式对齐 OfficeSearchBar。
    • 编程控制 API(双端对齐):Android OfficePreviewView 与 HarmonyOS OfficePreviewController / OfficePreviewActions 均提供 selectAll、clearSelection、hasSelection、getSelectedText、copySelection;剪贴板分别经 ClipboardManager 与 pasteboard.setDataSync 同步写入。打开新文档、清空与组件销毁时同步取消自动滚动、隐藏气泡并清空选区。
    • 支持范围:本期覆盖 DOCX 与 PPTX 的正文段落、文本框、浮动绕排文本与内嵌表格单元格;XLSX 暂不参与自由划词(selectAll 返回 false)。
    • 测试:新增纯 JVM scripts/tests/TextSelectionChecks.java(javac --release 11 -Xlint:all -Werror,已接入 CI)与 Node.js scripts/tests/TextSelectionChecks.ts,并扩展 OhosGestureChecks.ts 覆盖长按与双击阈值回归;Android 端新增设备 selection 专项 suite。

细节修复与交互优化

  • DOCX 行内图水平对齐与自适应文本框(core / viewer / viewer-ohos / viewer-macos):
    • 保留行内 <wp:inline> 图片所在段落的 jc 水平对齐属性(left / center / right),并在 Android、HarmonyOS NEXT 与 macOS 三端正文及缩略图渲染中按 horizontalAlign 正确居中或右对齐绘制。
    • 修复部分无边框透明不换行文本框的 autofit 尺寸测量,避免文字被误换行或截断;macOS 端同步居中画布上的文档与行内图形。
  • 选区交互与排版细节(viewer / viewer-ohos):
    • Android 端修复 StaticLineMetrics 非尾行边界保留、双击缩放时收起选区浮动气泡以及 PPTX 滚动进视口页面的选区布局懒补全。
    • HarmonyOS NEXT 端对齐行边界手柄吸附偏好与反向选区矩形归一化,保留 PPTX 组合/元素变换到选区高亮中,对齐 DOCX 表格高亮、空段落高度及延迟索引构建,并消除长按选词/缩放与平移单击手势的冲突。