如何用Apps Script自定义函数实现单元格内两行文本分色？

问题背景 #

需要将两行数据放入单个单元格并分别设置不同颜色。此前尝试用自定义函数pileUp实现了文本换行，但无法为部分文本着色；后续尝试RichTextValue的写法存在错误，且因两行文本长度不固定，无法用固定字符索引设置格式。

解决方案 #

单元格内直接调用的自定义函数无法返回RichTextValue并应用格式，需通过直接操作单元格的方式实现。以下是可行代码：

核心功能函数 #

function setPiledColoredText(cellRange, val1, val2, color1, color2) {
  // 创建两种文本样式，可自定义默认颜色
  const style1 = SpreadsheetApp.newTextStyle()
    .setForegroundColor(color1 || "#000000")
    .build();
  const style2 = SpreadsheetApp.newTextStyle()
    .setForegroundColor(color2 || "#b82f2f")
    .build();

  // 拼接带换行的完整文本
  const fullText = `${val1}\n${val2}`;
  // 构建富文本，根据文本长度动态设置样式范围
  const richText = SpreadsheetApp.newRichTextValue()
    .setText(fullText)
    .setTextStyle(0, val1.length, style1) // 为第一行文本应用样式
    .setTextStyle(val1.length + 1, fullText.length, style2) // 跳过换行符，为第二行应用样式
    .build();

  // 将富文本应用到目标单元格
  cellRange.setRichTextValue(richText);
}

示例调用 #

function exampleUsage() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  // 给A1单元格设置两行不同颜色的文本
  const targetCell = sheet.getRange("A1");
  setPiledColoredText(targetCell, "第一行内容", "第二行内容", "#2f6b2f", "#b82f2f");
}

便捷操作：添加自定义菜单 #

如果需要手动触发批量处理，可以添加自定义菜单：

function onOpen() {
  const ui = SpreadsheetApp.getUi();
  ui.createMenu("文本格式工具")
    .addItem("为选中单元格设置两行着色文本", "processSelectedCells")
    .addToUi();
}

function processSelectedCells() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const selectedRanges = sheet.getSelection().getRanges();
  
  // 示例：为选中单元格设置固定两行文本，可根据需求修改为从其他单元格取值
  selectedRanges.forEach(range => {
    setPiledColoredText(range, "第一行自定义内容", "第二行自定义内容", "#0000ff", "#ff0000");
  });
}

说明 #

• 通过val1.length动态确定第一行文本的结束位置，跳过换行符后设置第二行样式，完美适配文本长度不固定的场景。
• 若需批量处理，可修改processSelectedCells函数，从指定单元格读取两行文本数据，再批量应用格式。

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