Repository navigation
v0.15.0
发布页面: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与 HarmonyOSOfficePreviewController/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.jsscripts/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 表格高亮、空段落高度及延迟索引构建,并消除长按选词/缩放与平移单击手势的冲突。
- Android 端修复