Skip to content

v0.16.0

Latest

Choose a tag to compare

@donglua donglua released this 19 Nov 06:10

发布页面:v0.16.0 Release。

本版本新增 XLSX 单元格与区域选择复制全端支持(core / Android / HarmonyOS NEXT / macOS)、PPTX 图表与预设几何/虚线描边/连接线箭头扩展,以及 DOCX 表格单元格边框、背景底纹与垂直对齐全端支持,项目名称统一更名为 JZOfficeKit,schemaVersion 保持 9 不变。

排版与特性

  • DOCX 表格单元格边框、背景底纹与垂直对齐(core / Android / HarmonyOS NEXT / macOS):

    • 核心解析(core):Element 新增可选矩阵字段 cellValigns(0 顶部、1 垂直居中、2 底部)与 cellBorders(每格四边 [top, right, bottom, left] 的 { color, width },w:val="none" | "nil" 时为 0),继承表格级/单元格级边框与 <w:shd> 底纹解析(schemaVersion 保持 9)。
    • 三端渲染:Android(viewer)、HarmonyOS NEXT(viewer-ohos)与 macOS(viewer-macos)同步实现单元格四边独立边框绘制、合并单元格填充与单元格级垂直对齐排版。
  • XLSX 单元格与区域选择复制(Android / HarmonyOS NEXT / macOS):

    • 三端同构选区模型:新增零 UI 依赖的纯逻辑模型 SheetSelectionModel(Java / TypeScript / Swift),统一实现二维网格锚点-焦点选区、合并单元格不动点闭包扩张(选区与任何合并区域相交即并入其完整范围并迭代到稳定,避免选区被合并区域切开)、冻结窗格感知的 hitTest(按冻结边界消解滚动偏移,锁定轴不叠加滚动量,拖拽时按 clampToBounds 钳位到表格边缘继续扩选)、全选范围与 TSV 格式化。三端模型由同一套 111 项断言逐条校验,语义完全一致。
    • 合并单元格闭包吸附:单格落在合并区域内即自动扩张为整个合并区域;恰好覆盖单个合并区域时视为"逻辑单格",直接输出该单元格文本而非带尾随制表符的网格。
    • TSV 剪贴板格式:多格选区按行优先导出,同行可见列以 \t 分隔、跨行以 \n 分隔;隐藏行与隐藏列整条跳过(不留空列空行);合并区域从属位置输出空串以保持矩形对齐;含制表符/换行/回车/双引号的文本按 RFC 4180 用双引号包裹并把内部引号翻倍;选区内全为空文本时返回空串,不复制出纯空白网格。
    • 四象限高亮裁剪:选区填充(#261A73E8)与外框(#FF1A73E8,1.5 物理像素)在滚动区与三个冻结象限分别平移并裁剪绘制,跨冻结边界的选区不会覆盖冻结区,也与 Excel / WPS 的分块观感一致。
    • 行列标头联动高亮:落在选区行/列范围内的行号与列标改为 #D2E3FC 底色与 #174EA6 加粗文字,四个标头段(可滚动列、冻结列、可滚动行、冻结行)各自一致生效。
    • 交互:移动端长按选格后不抬手即可拖动扩选,并支持拖拽选区左上/右下双角手柄拉伸(固定物理尺寸、24dp/vp 热区)与边缘自动滚动;macOS 支持鼠标点选与拖拽框选。浮动「复制 / 全选」气泡复用既有 SelectionPopupMenu / SelectionMenuBubble。
    • 公开 API 闭环:selectAll / clearSelection / hasSelection / getSelectedText / copySelection 三端在 XLSX 下全部生效,selectAll 选中整表可见数据区(空表返回 false);Android 无障碍的「全选文本 / 复制选中文本 / 清除选区」不再排除 XLSX;macOS 支持 Cmd+A / Cmd+C 与右键菜单。切表、双击缩放、重新加载与 clear() 均清除选区。
    • 手势零退化:单指平滑滚动、惯性 Fling、双击缩放与双指捏合缩放行为不变;选区拖拽期间平移手势主动让路。捏合缩放对表格保留选区(缩放停稳后气泡重新贴回),双击缩放按设计约定清除表格选区(缩放过后的旧选区已无参考意义),DOCX / PPTX 的文本选区行为完全不变。
  • PPTX 图表扩展(core):

    • 横向条形图:识别 barChart 且 barDir="bar"(grouping 为 clustered / standard),按分类均分槽高、按数值比例从左向右绘制条形,数值全非负时自动把 0 纳入数值轴范围。
    • 饼图与环形图:新增 pieChart 与 doughnutChart 支持,扇区以三次贝塞尔拟合圆弧(每段圆心角不超过 90°,控制点切向系数 4/3·tan(α/4));环形图解析 <c:holeSize>(合法 1..=90,默认 50,内径比钳位到 0.1..=0.9),生成外弧与反向内弧闭合路径;单扇区 100% 时直接绕外圆闭合,不产生中心半径线。
    • 扇区配色与图例:优先使用 <c:dPt> 声明的填充色,未声明时回退主题强调色;图例按分类名逐项生成色块与文本。
    • 无坐标轴容错:饼图与环形图不再要求存在 catAx / valAx,缺失坐标轴时仍可正常渲染。
  • 预设几何扩展(core):新增 22 种高频 prstGeom(合计 26 种可绘制形状),覆盖 parallelogram、trapezoid、pentagon、hexagon、octagon、plus/mathPlus、snip1Rect、round2SameRect、四向箭头与双向箭头、chevron、homePlate、notchedRightArrow、star4/star5、flowChartProcess/Decision/Data/Terminator/Document 与 wedgeRectCallout。统一提取 adj 调整值读取函数,非法公式仍按既有语义整体省略并告警。

  • 虚线描边与连接线箭头(core / Android / HarmonyOS NEXT / macOS):

    • core 解析 <a:prstDash> 并按线宽换算为 Element.strokeDash(Vec<f32>,实线时按 skip_serializing_if 省略,旧文档 JSON 结构不变),支持 dot/sysDot、dash/sysDash、lgDash、dashDot/sysDashDot、lgDashDot、lgDashDotDot/sysDashDotDot。
    • 连接线 headEnd / tailEnd 编译为主干与端点箭头子路径(triangle/stealth 实心三角、arrow 开叉双翼线、diamond/oval 端点),按 len/w 属性缩放并受线段长度约束,实心箭头自动内缩主干避免刺穿尖端。
    • 三端分别以 DashPathEffect(Android)、ctx.setLineDash(HarmonyOS NEXT / macOS)绘制虚线,并在每次描边后立即恢复实线,避免样式泄漏。

测试

  • 新增 core/tests/docx_table_styling.rs(15 项用例)与 Android PptxTableChecks 校验 DOCX 表格单元格边框、底纹与垂直对齐;同步扩展 DocumentDecoderChecks.java 与 macOS JZOfficeTests.swift(全套 47 项用例通过)。
  • 新增纯 JVM scripts/tests/SheetSelectionChecks.java(111 项断言)与纯 TS scripts/tests/SheetSelectionChecks.ts(111 项断言 + 24 项集成静态检查),两者逐条对齐,并接入 CI rust-and-jvm 作业。
  • 不动点闭包用例使用相互重叠的合并区域构造,并已通过变异测试验证:把 resolve 退化为单轮遍历时该用例以 endColumn=2 失败,确保「不动点」语义真正被锁定(相邻但不重叠的合并区域在合法数据下无法串联,无法区分单轮与不动点)。
  • 扩展 Android 设备端 selection 套件的 XLSX 段:全选整表 TSV、Tab/换行结构、高亮像素比对、剪贴板往返、长按选中单元格、拖动扩选成多格网格、单击清除、切表清除选区与单指滚动零退化。
  • 扩展 macOS JZOfficeTests.swift 新增 16 项 XLSX 选区用例(合并闭包、冻结四象限命中、TSV 与 RFC 4180 转义、四象限裁剪绘制、鼠标换算、切表/换文档清选区、剪贴板),全套 47 项通过。
  • 新增 core/tests/pptx_charts_geometry.rs(15 项用例)覆盖横向条形图、饼图/环形图扇区与配色、22 种预设几何、虚线换算与箭头端点。
  • 扩展纯 JVM scripts/tests/DocumentDecoderChecks.java 校验 strokeDash 解码与非法输入拦截(140 → 155 项断言)。
  • 扩展 macOS JZOfficeTests.swift 覆盖 strokeDash 解码回退与离屏虚线间断绘制(31 项用例全通过)。

细节修复与交互优化

  • 项目更名(全端):仓库与工程对外名称统一更名为 JZOfficeKit,同步更新 Gradle 发布配置、OHPM 包主页与三端文档链接。
  • XLSX 选区手势、冻结窗格与缩放细节(viewer / viewer-ohos / viewer-macos):
    • 统一修复三端拖拽扩选越入行列标头时的坐标钳位(clamp)。
    • Android 端修复向 hitTestSheetCell 传入未偏移视图坐标、修正冻结象限选区裁剪及缩放屏幕边界,并补充设备端缩放触摸与选区恢复校验。
    • HarmonyOS NEXT 端修复冻结窗格选区屏幕矩形映射、平移/惯性滑动/捏合缩放时隐藏与重定位选区气泡,以及拖拽手柄期间拦截长按并隔离单击/双击手势。
    • macOS 端保持跨缩放级别的固定选区描边线宽,并修复光标切换与鼠标按下处理;同时修复紧边界 TEXT 文本框不再被裁切。
  • PPTX 图表与箭头绘制修正(core):对齐条形图坐标轴、饼图图例布局、流程图终止符圆弧及连接线箭头端点细节。