呈现内容项

内容布局用于呈现内容项。它们接收内容项数据,将其呈现到 HTML 中,以及将其插入到页中。

尽管可以采用任何 JavaScript 技术来实施内容项,但默认情况下,内容布局利用 Mustache 模板来呈现内容项。要使 Mustache 模板呈现出来,它需要特定格式的数据。内容布局 render.js 文件需要确保它传递到模板的模型匹配该格式。

下面是在多个用例中呈现内容布局的情况:

  • Oracle Content Management 资产管理 UI 中使用时,数据可以处于“已编辑”状态,以便用户在保存更改之前预览更改。

  • Oracle Content Management 站点中的内容列表或内容项中使用时,使用有关运行它的站点的其他信息扩充数据。

  • 通过 Content SDK 的 contentClient.renderLayout() 调用使用时,在此情况下 Content SDK 用户将其所需的任何数据直接传递到内容布局。

出于性能考虑,通常会在创建单个查询(可以返回所有所需数据)或多个查询(以便通过快速初始查询尽快呈现外框,然后通过后续查询填充各区域)之间进行权衡。您选择的模型取决于您的数据和用例。

此外,传递到内容布局的数据的格式可能会因数据检索方式而不同。例如,如果您将内容 REST 与扩展参数结合使用,则可能还会返回对其他内容项的字段引用(单个或成组)。如果未包括所引用的内容项,您将需要进行额外的 REST 调用。

要处理所有情况,内容布局开发人员应尝试灵活处理收到的数据的格式。此外,必要时,开发人员可以提取其他数据并将数据强制转换为呈现模板所需的格式。