Outlook加载项希伯来语翻译及RTL右对齐适配问题咨询

1. XML 清单文件多语言配置 #

• 无需单独创建多份清单，直接在现有清单的<Resources>节点下新增希伯来语（locale代码为he-IL）的资源覆写配置即可，示例如下：

<Resources>
  <!-- 默认语言资源 -->
  <bt:String id="AddinName" DefaultValue="邮件模板插件" />
  <bt:String id="AddinDesc" DefaultValue="快速生成预设格式的邮件模板" />
  <!-- 希伯来语资源覆写 -->
  <bt:Override Locale="he-IL" StringId="AddinName" Value="תוסף תבניות דואר" />
  <bt:Override Locale="he-IL" StringId="AddinDesc" Value="יצירה מהירה של תבניות דואר בפורמט מוגדר מראש" />
</Resources>

• 清单层面不需要额外配置RTL规则，Outlook会自动根据he-IL的locale属性，对插件入口、右键菜单等系统渲染的模块做RTL适配。如果使用的是新版统一JSON清单，在localization数组中新增对应语言配置即可，逻辑一致。

2. JS 代码多语言适配 #

• 先整理多语言资源映射表，将所有前端和模板用到的文案按语言维度归类：

const langResource = {
  'zh-CN': {
    meetingTemplate: '会议邀请',
    sendBtn: '发送',
    tip: '模板生成成功'
  },
  'he-IL': {
    meetingTemplate: 'הזמנת פגישה',
    sendBtn: 'שלח',
    tip: 'התבנית נוצרה בהצלחה'
  }
}

• 调用Office.context.displayLanguage获取用户当前Outlook界面的语言代码，匹配对应资源包即可。如果支持用户手动切换语言，优先读取本地存储的用户选中语言。

3. RTL（从右到左）适配 #

3.1 插件自身界面RTL #

• 当检测到当前使用语言为希伯来语时，给页面根节点添加dir="rtl"属性，浏览器会自动处理文本对齐、元素排版、滚动条位置等RTL适配逻辑，无需大范围调整CSS：

const currentLang = Office.context.displayLanguage.toLowerCase()
if (currentLang === 'he-il') {
  document.documentElement.setAttribute('dir', 'rtl')
} else {
  document.documentElement.setAttribute('dir', 'ltr')
}

• 存在特殊样式需要调整时，配合[dir="rtl"]选择器做差异化CSS配置即可。

3.2 生成邮件模板的RTL适配 #

• 生成HTML格式的希伯来语邮件时，在外层容器添加lang="he-IL"和dir="rtl"属性，确保各类邮件客户端可以正确识别排版方向：

<!-- 希伯来语邮件模板结构 -->
<div lang="he-IL" dir="rtl">
  <h2>{{meetingTemplate}}</h2>
  <p>תוכן הדואר כאן</p>
  <!-- 混合英文/数字等LTR内容时单独指定方向避免错乱 -->
  <p>מספר הזמנה: <span dir="ltr">ORD123456</span></p>
</div>

• 生成纯文本格式邮件时，可在文本开头添加RTL控制字符\u200F，强制客户端识别文本方向，避免排版错乱。

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