页面排序与旋转(页面模型)
对混合横竖页应用 order 排列与 rotations 角度,只提交位置和角度实际改变的页;no-op 时 commitCount=0。
输入与参数
document— 单份文档页面模型(JSON)order— 页面 id 顺序(逗号分隔,可留空保持原序)rotations— 旋转映射(JSON,角度为 90 的整数倍)
真实示例
document=5页混合横竖模型(p1 横、p2 竖…);order=p2,p1,p3,p4,p5;rotations={"p2":90}
→ plan.commitCount=2;changed=[{id:"p2",fromIndex:2,toIndex:1,fromRotation:0,toRotation:90},{id:"p1",fromIndex:1,toIndex:2,...}];unchangedIds=["p3","p4","p5"]。空编辑 commitCount=0。
限制与失败处理
order 必须是原页面 id 的不重复排列;rotations 只允许已知页面且角度为 90 的倍数;只输出变更清单,不重新渲染页面、不生成 PDF;打开下载结果核对方向一项未实测。
FAQ
旋转 45 度可以吗?
不可以,返回 INVALID_ROTATION;角度必须是 90 的整数倍并归一化到 0/90/180/270。
能核对下载结果的页面方向吗?
本轮不能。真实 PDF 引擎未集成/未实测,没有可打开的结果文件;JSON 计划里只记录目标方向与角度,需在后续集成后做浏览器实测。