EcmaScript 和服务器功能区
上次修改时间: 2011年2月7日
适用范围: SharePoint Foundation 2010
可以通过多种方法将 ECMAScript(JavaScript、JScript)添加到 Microsoft SharePoint Foundation 的页面中。本主题列出了用于将 JavaScript 添加到页面中以便与服务器功能区进行交互的最常见方法。
将 EcmaScript(JavaScript、JScript)添加到页面中
可以使用以下方法之一在页面上放置自定义 JavaScript:
以页面上的委托控件(如 AdditionalPageHead)为目标。
在页面上添加 Web 部件。
对自定义操作的 Location 属性使用 ScriptLink。
可以向 AdditionalPageHead 委托中添加控件以便在页面中插入 JavaScript。当面向特定的自定义列表时可采用此方法。当使用特定的文档库或列表时,控件可确定当前列表并根据需要输出 JavaScript。通过这种方式输出脚本可获得更好的性能。您可以使用 System.Web.UI.Page 对象的 ClientScriptManagerRegisterClientScriptBlock() 方法来输出脚本。
可以向页面上添加 Web 部件,并通过使用 System.Web.UI.Page 对象的 ClientScriptManagerRegisterClientScriptBlock() 方法或通过在页面中直接插入脚本,来注册脚本。当服务器功能区按钮与发出 JavaScript 的 Web 部件相关时,应使用这种添加 JavaScript 的方法。
通过将 ScriptLink 用作自定义操作的 Location 属性,可将脚本添加到 Microsoft.SharePoint.SPSite 级别的页面上。网站中的所有页面上都将具有脚本。当在网站中的大多数页面上使用 JavaScript 时,可使用这种类型的自定义。
使用的自定义的类型取决于方案的作用域。有关功能区上的按钮的网站集合级别的替换的示例,请参阅演练:替换服务器功能区中的网站集按钮。