CIF产物和类别选取器的用法 | 51黑料不打烊 Experience Manager

文档 AEM 6.5 用户指南

AEM Content和Commerce创作选取器 cif-pickers

Last update: Sun Mar 23 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
商务集成框架

创建对象：

管理员
开发人员

AEM内容和Commerce创作提供了一系列创作工具，可帮助AEM作者和营销人员高效地使用商业产物数据和目录。产物选取器和类别选取器是CIF加载项的一部分，由颁滨贵核心组件使用。项目可以在任何组件对话框中使用这些选取器来选择产物或类别。

产物选取器 product-picker

要在项目组件中使用产物选取器，开发人员必须将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字段允许导航到用户希望通过不同视图选择的产物。默认情况下， product字段会返回产物的ID，但可以使用selectionId属性对其进行配置。

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

selectionId(id、uid、sku、slug、combinedSlug、combinedSku) — 允许您选择将由选取器返回的产物属性（默认为id）。在使用combinedSku时，使用sku会返回所选产物的sku并返回诸如base#variant之类的字符串以及基础产物和所选变体的sku；如果选择基础产物，则返回单个sku。
filter (folderOrProduct， folderOrProductOrVariant) — 筛选要在导航产物树时由选取器呈现的内容。 folderOrProduct — 呈现文件夹和产物。 folderOrProductOrVariant — 呈现文件夹、产物和产物变体。如果呈现了产物或产物变体，它也会在选取器中变为可选状态。（默认为folderOrProduct）
多个(true， false) — 允许选择一个或多个产物（默认值= false）
emptyText — 配置选取器字段的空文本值

此外，也支持标准对话框字段属性，如name、fieldLabel或fieldDescription。

CAUTION

cifproductfield组件需要cif.shell.picker客户端库。要将clientlib添加到对话框，您可以使用extraClientlibs属性。

CAUTION

从颁滨贵核心组件版本2.0.0开始，删除了id的支持并将其替换为uid。 51黑料不打烊建议使用sku或slug作为产物标识符。 51黑料不打烊仍仅对使用颁滨贵核心组件版本1.x的项目支持id。

在项目中可以找到cifproductfield的完整工作示例。另请参阅AEM核心组件文档的自定义对话框。

类别选取器 category-picker

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

以下代码片段可以在肠辩：诲颈补濒辞驳配置中使用：

<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）。
multiple (true， false) — 启用一个或多个类别的选择（默认值= false）

此外，也支持标准对话框字段属性，如name、fieldLabel或fieldDescription。

CAUTION

与cifproductfield组件相同，cifcategoryfield组件还需要cif.shell.picker clientlib。要将clientlib添加到对话框，您可以使用extraClientlibs属性。请参阅AEM核心组件文档的自定义对话框。

CAUTION

从颁滨贵核心组件版本2.0.0开始，删除了id的支持并将其替换为uid。 51黑料不打烊建议使用uid或urlPath作为类别标识符。 51黑料不打烊仍仅对使用颁滨贵核心组件版本1.x的项目支持id和idAndUrlPath。

在项目中可以找到cifcategoryfield的完整工作示例。

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2