将 jQuery 添加到方案
jQuery 库是 JavaScript 库。IBM® WebSphere® Portal 包含 jQuery 核心的 jQuery 模块,以便您可在主题中使用 jQuery。
关于此任务
缺省情况下,未打开此 jQuery 模块。jQuery 是开放式框架,且不受 IBM 支持。通过此模块,可快速、轻松地在主题中使用 jQuery 及其任一插件。
过程
- 要打开 jQuery,请将 jquery1.10.2.json 模块定义文件复制到 WebDAV fs-type1 中的主题 contributions 文件夹中。可以在以下路径找到此 jquery1.10.2.json 文件:PortalServer\theme\wp.theme.jquery\installedApps\wp.theme.jquery.ear\wp.theme.jquery.war\v1.10.2。
- 可选: 要使用 jQuery 核心启用插件,请从 jQuery Web 站点下载 jQuery 插件。有关更多信息,请参阅相关链接中的“jQuery 插件下载”。在此示例中,使用 PowerTip 插件。jquery.powertip-1.2.0.zip 文件。要下载插件,请参阅相关链接中的“jQuery PowerTip 插件下载”。
- 将插件文件的内容解压缩到任何位置。
- 在主题的模块文件夹中为插件创建子文件夹,例如,此示例中为 jquery_powertip。
- PowerTip 插件具有必须为模块的 head 添加项的两个文件,以便在 jquery_powertip 文件夹中创建 head 子文件夹。
- 将所需资源文件从解压缩插件的位置复制到 head 文件夹。在此示例中,所需资源文件为:
jquery.powertip.min.js jquery.powertip.js jquery.powertip.min.css jquery.powertip.css - 同时复制文件的 Min 和非 Min 版本。缺省情况下,为确保性能自动使用 Min 版本,打开调试方式时,自动使用非 Min 版本。
- 此示例使用提示的缺省颜色方案。但是,PowerTip 提供了在其 CSS 文件夹中的单独 CSS 文件中定义的多个颜色方案。您可更改为其他颜色方案中的其中一个颜色方案,可以通过将不同 CSS 文件放置到 head 文件夹来创建您自己的颜色方案。 例如,要获取浅色方案,可以改为将 CSS 文件复制 head 文件夹中。
jquery.powertip-light.min.css jquery.powertip-light.css - jquery_powertip 模块以 jQuery 模块为prereqs,因此您需要在 modules\jquery_powertip 文件夹中创建名为 prereqs.properties 且具有以下内容的文件:
jquery - 如果具有更多插件,那么可以在主题模块文件夹中为它们定义相似模块定义文件夹。针对每个模块定义,为模块指定以 jquery_ 开头的文件夹名称,例如,本示例中为 jquery_powertip。以 jquery 模块为先决条件。
- 将模块 jquery 添加到其中一个主题概要文件的模块列表中。最好是复制其中一个现有概要文件然后修改副本,而不是直接进行修改。复制您希望与其类似的基本概要文件(例如,profile_deferred.json),并将其重命名为诸如 profile_jquery_deferred.json 的名称,然后添加模块 jquery。创建概要文件时,调整标题和描述,以便您的概要文件具有唯一、可识别的标题和描述。 例如,将标题和描述更改为
"titles": [ { "value": "jQuery Deferred", "lang": "en" } ], "descriptions": [ { "value": "This profile has jQuery plus the full set of modules for the theme, but defers loading most of these modules unless actually needed. This profile balances function and performance.", "lang": "en" } ] - 可选: 将插件模块添加到概要文件中的模块列表中,例如,在本示例中,添加模块 jquery_powertip。
- 使高速缓存失效,以便 Portal 服务器获取您的概要文件和模块更改。单击管理菜单图标。然后,单击门户网站分析 > 主题分析器。 然后,单击实用程序 > 控制中心 > 使高速缓存失效 > 单击以使其失效。自动失效功能可自动识别您对基于 WebDAV 的主题所做的更改。无需进一步操作。有关更多信息,请参阅实用程序。
- 将概要文件应用到页面。在编辑页面属性 > 高级中,选择概要文件:jQuery Deferred。
- 要验证页面上是否装入了 jQuery 以及装入的版本,可以在浏览器开发者工具的控制台中运行 $().jquery。 它会回传 jQuery 版本号。