Repository navigation
发布页面: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 的文本选区行为完全不变。
- 三端同构选区模型:新增零 UI 依赖的纯逻辑模型
-
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 项用例)与 AndroidPptxTableChecks校验 DOCX 表格单元格边框、底纹与垂直对齐;同步扩展DocumentDecoderChecks.java与 macOSJZOfficeTests.swift(全套 47 项用例通过)。 - 新增纯 JVM
scripts/tests/SheetSelectionChecks.java(111 项断言)与纯 TSscripts/tests/SheetSelectionChecks.ts(111 项断言 + 24 项集成静态检查),两者逐条对齐,并接入 CIrust-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):对齐条形图坐标轴、饼图图例布局、流程图终止符圆弧及连接线箭头端点细节。