SharePoint 加载项模型中的本地化
在新 SharePoint 外接程序模型中实施外接程序本地化的方法与使用完全信任代码不同。 在典型的完全信任代码 (FTC) /场解决方案方案中,自定义组件(如 Web 部件、用户控件和 Web 控件)的本地化是使用资源文件、.Net 托管代码、属性和声明性代码的组合实现的。 所有项目打包到由 SharePoint 解决方案部署的功能中。
在 SharePoint 外接程序模型场景中,使用 JavaScript 或与你构建外接程序使用的 Web 技术相关联的本地化功能实现本地化。 根据本地化的资源,还可以使用经典资源文件,例如,需要使用外接程序定义中的功能框架元素本地化部署到外接程序 Web 的元素时。
高级别准则
作为经验法则,我们将提供以下有关实施本地化的高级别准则。
- 必须在 SharePoint 本地和 Office 365 环境中安装适当的语言包,以使用户在特定语言和文化中创建网站。
- 你也可以使用在 SharePoint 外接程序中使用 JavaScript 实现本地化的方法来对脚本编辑器外接程序部件中的内容进行本地化。
本地化场景
需要对两种不同的场景实施外接程序的本地化。
- SharePoint 托管的外接程序
- 提供商托管的外接程序
外接程序 Web 组件或资产
此场景通过 JavaScript 向外接程序应用本地化。
- SharePoint 托管的外接程序无权访问 SharePoint 服务器中基于服务器的资源文件,但您有权访问功能元素 *.resx 文件。
- 本地化 SharePoint 托管的外接程序和本地化 Office 外接程序所使用的方法非常相似,因为它们都使用 JavaScript。
何时适合?
创建 SharePoint 托管的外接程序时使用 JavaScript 是最佳选择,因为你可以使用 JavaScript 实现本地化并部署所有必要的 JavaScript 文件,以支持 SharePoint 托管的外接程序的本地化。 如果你的提供程序托管的外接程序也包含特定的外接程序 Web,那么你还可以利用此方法。
开始使用
Core.JavaScriptCustomization(O365 PnP 示例)中的场景 2 演示了如何使用 JavaScript 来本地化外接程序中的文字,以及外接程序中与 HTML 元素关联的属性。
本地化 SharePoint 外接程序 还演示了如何使用 JavaScript 以本地化外接程序 Web 中的资产。
远程组件
此场景中,本地化通过与托管外接程序的 Web 技术相关联的本地化技术应用于外接程序。
- 当 ASP.NET 用于实施外接程序时,资源文件和 JavaScript 文件用于对其进行本地化。
- 当例如 PHP、Python 或 Ruby 的另一技术用于实施外接程序时,将使用与这些平台相关联的功能。
何时适合?
创建由提供商托管的外接程序时,使用随 Web 托管平台一起提供的本地化技术是最佳选择,因为你使用不引入自定义代码或其他复杂性的方式构建外接程序。
开始使用
以下文章介绍了如何使用资源文件和 JavaScript 来本地化由提供商托管的外接程序。
相关链接
- 本地化 SharePoint 外接程序(MSDN 文章)
- 本地化外接程序的外接程序 Web、主机 Web 和远程组件 (Office Dev GitHub 示例)
- 指南文章中 https://aka.ms/OfficeDevPnPGuidance
- MSDN 中的引用位于 https://aka.ms/OfficeDevPnPMSDN
- 视频中的 https://aka.ms/OfficeDevPnPVideos
PnP 示例
适用于
- Office 365 多租户 (MT)
- Office 365 专用 (D)
- SharePoint 2013 本地