将 jQuery 添加到方案

jQuery 库是 JavaScript 库。IBM® WebSphere® Portal 包含 jQuery 核心的 jQuery 模块,以便您可在主题中使用 jQuery。

关于此任务

缺省情况下,未打开此 jQuery 模块。jQuery 是开放式框架,且不受 IBM 支持。通过此模块,可快速、轻松地在主题中使用 jQuery 及其任一插件。

过程

  1. 要打开 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
  2. 可选: 要使用 jQuery 核心启用插件,请从 jQuery Web 站点下载 jQuery 插件。有关更多信息,请参阅相关链接中的“jQuery 插件下载”。在此示例中,使用 PowerTip 插件。jquery.powertip-1.2.0.zip 文件。要下载插件,请参阅相关链接中的“jQuery PowerTip 插件下载”。
    1. 将插件文件的内容解压缩到任何位置。
    2. 在主题的模块文件夹中为插件创建子文件夹,例如,此示例中为 jquery_powertip
    3. PowerTip 插件具有必须为模块的 head 添加项的两个文件,以便在 jquery_powertip 文件夹中创建 head 子文件夹。
    4. 将所需资源文件从解压缩插件的位置复制到 head 文件夹。在此示例中,所需资源文件为:
      jquery.powertip.min.js
      jquery.powertip.js
      jquery.powertip.min.css
      jquery.powertip.css
    5. 同时复制文件的 Min 和非 Min 版本。缺省情况下,为确保性能自动使用 Min 版本,打开调试方式时,自动使用非 Min 版本。
    6. 此示例使用提示的缺省颜色方案。但是,PowerTip 提供了在其 CSS 文件夹中的单独 CSS 文件中定义的多个颜色方案。您可更改为其他颜色方案中的其中一个颜色方案,可以通过将不同 CSS 文件放置到 head 文件夹来创建您自己的颜色方案。 例如,要获取浅色方案,可以改为将 CSS 文件复制 head 文件夹中。
      jquery.powertip-light.min.css
      jquery.powertip-light.css
    7. jquery_powertip 模块以 jQuery 模块为prereqs,因此您需要在 modules\jquery_powertip 文件夹中创建名为 prereqs.properties 且具有以下内容的文件:
      jquery
    8. 如果具有更多插件,那么可以在主题模块文件夹中为它们定义相似模块定义文件夹。针对每个模块定义,为模块指定以 jquery_ 开头的文件夹名称,例如,本示例中为 jquery_powertip。以 jquery 模块为先决条件。
  3. 将模块 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"
          }
       ]
  4. 可选: 将插件模块添加到概要文件中的模块列表中,例如,在本示例中,添加模块 jquery_powertip
  5. 使高速缓存失效,以便 Portal 服务器获取您的概要文件和模块更改。单击管理菜单图标。然后,单击门户网站分析 > 主题分析器 然后,单击实用程序 > 控制中心 > 使高速缓存失效 > 单击以使其失效自动失效功能可自动识别您对基于 WebDAV 的主题所做的更改。无需进一步操作。有关更多信息,请参阅实用程序
  6. 将概要文件应用到页面。在编辑页面属性 > 高级中,选择概要文件:jQuery Deferred
  7. 要验证页面上是否装入了 jQuery 以及装入的版本,可以在浏览器开发者工具的控制台中运行 $().jquery 它会回传 jQuery 版本号。

结果

现在,jQuery 核心和插件准备就绪,可供使用。要了解有关 jQuery 核心使用情况的基本信息,请参阅相关链接中的“jQuery 基本信息”。可以在下载插件的相同站点上了解插件的使用。有关更多信息,请参阅“PowerTip 下载”。