Outlook for Mac使用Office API替换邮件正文致项目符号丢失问题

我之前也踩过这个坑！当你用office.context.mailbox.item.body.setAsync直接替换邮件正文时，很容易因为忽略了富文本格式的DOM结构，导致原有的项目符号列表变成纯文本。

问题根源 #

邮件正文的项目符号是通过HTML的<ul>/<ol>和<li>标签实现的。如果你的代码直接生成新的HTML内容，没有完整保留原正文里的这些嵌套结构，或者没有指定正确的格式类型，setAsync就会把列表解析成普通文本，丢失项目符号样式。

正确的解决方案：先获取原HTML再追加内容 #

不要直接替换整个正文，而是先获取当前正文的完整HTML，在末尾追加你的标签，再写回邮件。这样能完整保留原有的格式，包括项目符号。

示例代码：

// 第一步：获取当前邮件的HTML格式正文
Office.context.mailbox.item.body.getAsync(Office.CoercionType.Html, (getResult) => {
  if (getResult.status !== Office.AsyncResultStatus.Succeeded) {
    console.error('获取正文失败:', getResult.error.message);
    return;
  }

  // 原正文HTML
  const originalHtml = getResult.value;
  // 要追加的标签内容（用正确的HTML结构）
  const tagBlock = `
    <div style="margin-top:16px;">
      <strong>标签：</strong>
      <ul style="margin:8px 0;padding-left:24px;">
        <li>项目进度</li>
        <li>待跟进</li>
      </ul>
    </div>
  `;

  // 拼接原正文和新标签
  const updatedHtml = originalHtml + tagBlock;

  // 第二步：将拼接后的HTML写回邮件正文
  Office.context.mailbox.item.body.setAsync(updatedHtml, {
    coercionType: Office.CoercionType.Html // 必须指定HTML格式
  }, (setResult) => {
    if (setResult.status === Office.AsyncResultStatus.Failed) {
      console.error('更新正文失败:', setResult.error.message);
    }
  });
});

关键注意点 #

1. 指定coercionType：一定要在setAsync的选项里加上coercionType: Office.CoercionType.Html，确保Office以HTML格式处理内容，而不是纯文本。
2. 保持HTML结构完整：追加的标签内容也要用标准的HTML结构，比如列表要正确嵌套<ul>和<li>，不要用-这种纯文本符号代替。
3. 避免破坏原DOM：不要随意修改原正文的HTML结构，只在末尾追加独立的内容区块，防止原有的列表、段落等格式被意外破坏。

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