Repository navigation
v0.10.0
发布页面:v0.10.0 Release。
本版本主要新增 OfficeMetadata、OfficeThumbnail、OfficeSheetTabs 三个标准组件,并升级双端手势缩放越界回弹与鸿蒙 PPTX 统一矢量视口。
手势与视口
- 缩放越界抵抗与回弹:双端引入橡胶带(rubber-band)阻尼,双指捏合越界后按抵抗曲线让步,松手以 220 ms 减速动画回弹到边界(1.0x/4.0x,表格为 0.5x/4.0x);双击与读屏无障碍缩放动作同样采用该补间。
- 鸿蒙 PPTX 统一 2D 矢量视口:改用单层全屏 Canvas,支持全向拖拽、
displaySync驱动的惯性抛掷、焦点双指缩放与双击补间缩放,缩放直接作用于绘图矩阵保持矢量清晰,并加入视口裁剪与页码胶囊。
组件化与标准包装
- 无头元数据读取(
OfficeMetadata):Android 与 HarmonyOS NEXT 双端提供无头文档元数据快速读取接口(OfficeMetadata.read/readAsync与readOfficeMetadata),支持在不初始化 UI 视图的情况下快速获取文档格式(DOCX / PPTX / XLSX)、页数、宽高尺寸、工作表名称列表及告警信息。 - 离屏封面/缩略图生成(
OfficeThumbnail):Android 端提供OfficeThumbnail.decode/loadAPI,鸿蒙端提供renderOfficeThumbnail(filePath, maxWidth, maxHeight),支持双端脱离 UI 视图离屏渲染文档首页面(PPTX 幻灯片、DOCX 首屏、XLSX 工作表)为指定最大边界的Bitmap/PixelMap,带严格的内存预算与资源自动释放机制。 - 多工作表切换标准组件(
OfficeSheetTabs):- Android 沉淀
cn.jingzhuan.lib.office.widget.OfficeSheetTabs组件,支持attachTo(OfficePreviewView)自动联动绑定及窗口重挂载恢复,Demo 模块已完成解耦接入并移除旧私有类。 - 鸿蒙端导出声明式
@Component OfficeSheetTabs,支持仅传入controller自动订阅工作表列表与激活页码联动(非 XLSX 自动隐藏),并接入demo-ohos演示工程。
- Android 沉淀
- 双端多监听器扩展:Android
OfficePreviewView与鸿蒙OfficePreviewController均新增addOnPageChangeListener与removeOnPageChangeListener,支持与外部扩展组件解耦联动。