如何用Google Apps Script确保Google Docs中图片与描述标签同页？

要避免描述标签和图片被分页拆分，核心是让两者成为不可被分页分隔的关联元素，以下是几种可行的修改方案：

方案1：设置描述段落的同页跟随属性 #

给描述段落添加keepWithNext属性，强制它与紧随其后的图片保持在同一页面，代码改动最小：

// 插入描述段落并设置与下一个元素同页
const descPara = body.insertParagraph(indexOfStartElement++, value[0] + ": ");
descPara.setKeepWithNext(true);
// 插入图片
body.insertImage(indexOfStartElement++, getImage(info[value[0]][0]));

setKeepWithNext(true)会告诉Google Docs，这个段落必须和下一个元素处于同一页面，不会被分页拆分。

方案2：将图片嵌入描述段落 #

把图片直接添加到描述段落的末尾，让两者属于同一个段落元素，自然不会被跨页拆分：

// 插入描述段落
const descPara = body.insertParagraph(indexOfStartElement++, value[0] + ": ");
// 将图片追加到描述段落末尾
descPara.appendInlineImage(getImage(info[value[0]][0]));
// 注意：此时只插入了一个段落，indexOfStartElement的递增逻辑可根据实际情况调整

方案3：用无框表格包裹（视觉无干扰） #

创建一个单行单列的表格，将描述和图片放入同一个单元格，表格行默认不会被跨页拆分，还可以去掉边框保持视觉简洁：

// 插入单行表格
const table = body.insertTable(indexOfStartElement++, [[""]]);
const cell = table.getCell(0, 0);
// 添加描述和图片到单元格
cell.appendParagraph(value[0] + ": ");
cell.appendImage(getImage(info[value[0]][0]));
// 移除表格边框，避免影响文档样式
table.setBorderWidth(0);
indexOfStartElement++;

内容的提问来源于stack exchange，提问作者ppx