关于在 Office Addin 中为 Word 创建自定义样式的问题咨询

我目前正在开发一款 Office Addin，需要创建自定义样式供用户设置文本格式使用，现有两个相关问题咨询：一是通常情况下是否支持创建自定义样式？二是创建的自定义样式能否在 ribbon 的样式板块中展示？

1. 是否支持创建自定义样式？ #

目前Office JS API全面支持自定义样式创建能力，覆盖桌面端、网页版Office的Word、Excel、PowerPoint等主流应用：

• Word场景可通过Styles.Add()方法创建段落样式、字符样式、列表样式、表格样式，支持自定义字体、行距、缩进、边框等所有原生样式支持的配置项
• Excel场景可通过Workbook.Styles.Add()方法创建单元格自定义样式，支持配置填充、字体、对齐、数字格式等属性
• PowerPoint场景可通过操作幻灯片母版的样式集合，添加全局生效的自定义文本、段落样式

以下是Word创建自定义标题样式的示例代码：

await Word.run(async (context) => {
  // 新增名为「自定义一级标题」的段落样式
  const customStyle = context.document.styles.add("自定义一级标题", Word.StyleType.paragraph);
  // 配置样式属性
  customStyle.font.name = "微软雅黑";
  customStyle.font.size = 24;
  customStyle.font.bold = true;
  customStyle.paragraphFormat.spaceAfter = 12;
  customStyle.paragraphFormat.outlineLevel = Word.OutlineLevel.level1;
  await context.sync();
});

2. 创建的自定义样式能否在Ribbon的样式板块中展示？ #

完全可以，分为两种实现场景：

• 调用原生API创建的文档级自定义样式，会自动加入当前文档的原生样式库，直接在Office默认Ribbon的「样式」板块、样式面板中展示，用户可以和使用原生系统样式一样直接点击应用
• 如果你需要将自定义样式固定在插件专属的Ribbon区域，也可以通过修改Add-in的XML清单文件，自定义Ribbon标签页、功能组，添加样式快捷触发按钮，用户点击按钮即可快速应用对应样式

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