AEM Content & Commerce创作选取器

AEM Content & Commerce Authoring提供了一套创作工具，可帮助AEM作者和营销人员高效地处理商务产品数据和目录。 产品选取器和类别选取器是CIF附加组件的一部分，供CIF核心组件使用。 项目可以在任何组件对话框中使用这些选取器来选择产品或类别。

产品选取器

要在项目组件中使用产品选取器，开发人员必须添加 commerce/gui/components/common/cifproductfield 对话框。 例如，对cq使用以下内容:dialog:

<product jcr:primaryType="nt:unstructured"
    sling:resourceType="commerce/gui/components/common/cifproductfield"
    fieldDescription="The product or product variant displayed by the teaser"
    fieldLabel="Select Product"
    filter="folderOrProductOrVariant"
    name="./selection"
    selectionId="sku"/>

产品字段允许通过不同视图导航到用户要选择的产品。 默认情况下，product字段会返回产品的ID，但可以使用 selectionId 属性。

产品选取器字段支持以下可选属性：

  • selectionId(id、uid、sku、sug、combinedSlug、combinedSku) — 允许选择选取器返回的产品属性（默认= id）。 使用sku可返回选定产品的SKU，使用combinedSku时，将返回诸如base#variant之类的字符串（其中包含基本产品和所选变体的SKU）；或者，如果选择了基本产品，则返回单个SKU。
  • filter(folderOrProduct、folderOrProductOrVariant) — 在导航产品树时筛选器要呈现的内容。 folderOrProduct — 渲染文件夹和产品。 folderOrProductOrVariant — 渲染文件夹、产品和产品变体。 如果某个产品或产品变体已呈现，则它也会在选取器中变为可选。 （默认值= folderOrProduct）
  • 多个(true， false) — 启用对一个或多个产品的选择(default = false)
  • emptyText — 配置选取器字段的空文本值

此外，标准的图表字段属性，如 name, fieldLabel或 fieldDescription 也受支持。

注意

的 cifproductfield 组件需要 cif.shell.picker clientlib。 要向对话框中添加clientlib，您可以使用extraClientlibs属性。

注意

从CIF核心组件版本2.0.0开始，支持 id 已删除，替换为 uid. 我们强烈建议使用 sku 或 slug 作为产品标识符。 我们继续支持 id 仅适用于使用CIF核心组件版本1.x的项目。

的完整工作示例 cifproductfield 可在 CIF核心组件 项目。 另请参阅 自定义对话框 AEM核心组件文档的“受众”部分。

类别选取器

类别选取器也可在组件对话框中使用，其方式与产品选取器类似。

以下代码片段可在cq:dialog配置中使用：

<category jcr:primaryType="nt:unstructured"
    sling:resourceType="commerce/gui/components/common/cifcategoryfield"
    fieldLabel="Category"
    name="./categoryId"
    selectionId="uid" />

类别选取器字段支持以下可选属性：

  • selectionId(id， uid， slug， urlPath， idAndUrlPath) （已弃用）, uidAndUrlPath （已弃用）) — 用于选择选取器要返回的类别属性（默认值= id）。
  • 多个(true， false) — 启用一个或多个类别的选择(default = false)

此外，标准的图表字段属性，如 name, fieldLabel或 fieldDescription 也受支持。

注意

与 cifproductfield 组件 cifcategoryfield 组件还要求 cif.shell.picker clientlib。 要向对话框中添加clientlib，您可以使用 extraClientlibs 属性。 请参阅 自定义对话框 AEM核心组件文档的“受众”部分。

注意

从CIF核心组件版本2.0.0开始，支持 id 已删除，替换为 uid. 我们强烈建议使用 uid 或 urlPath 作为类别标识符。 我们继续支持 id & idAndUrlPath 仅适用于使用CIF核心组件版本1.x的项目。

的完整工作示例 cifcategoryfield 可在 CIF核心组件 项目。

在此页面上