AEM Content & Commerce创作选取器 cif-pickers
AEM Content & Commerce Authoring提供了一组创作工具,以帮助AEM作者和营销人员有效地使用商业产品数据和目录。 产品选取器和类别选取器是CIF加载项的一部分,由CIF核心组件使用。 项目可以在任何组件对话框中使用这些选取器来选择产品或类别。
产品选取器 product-picker
要在项目组件中使用产品选取器,开发人员必须添加 commerce/gui/components/common/cifproductfield
到组件对话框。 例如,对cq使用以下内容
<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)。 使用SKU可返回所选产品的SKU。 使用combinedSku会返回诸如base#variant之类的字符串以及基础产品和选定变体的SKU,如果选择了基础产品,则返回单个SKU。
- filter (folderOrProduct, folderOrProductOrVariant) — 筛选要在导航产品树时由选取器呈现的内容。 folderOrProduct — 呈现文件夹和产品。 folderOrProductOrVariant — 呈现文件夹、产品和产品变体。 如果呈现了产品或产品变体,它也会在选取器中变为可选状态。 (默认为folderOrProduct)
- 多个(true, false) — 允许选择一个或多个产品(默认值= false)
- emptyText — 配置选取器字段的空文本值
此外,标准对话框字段属性,如 name
, fieldLabel
,或 fieldDescription
,受支持。
CAUTION
此
cifproductfield
组件需要 cif.shell.picker
clientlib。 要将clientlib添加到对话框,您可以使用extraClientlibs属性。CAUTION
从CIF核心组件版本2.0.0开始,支持
id
已移除并替换为 uid
. Adobe建议使用 sku
或 slug
作为产品标识符。 Adobe继续支持 id
仅适用于使用CIF核心组件1.x版的项目。的完整工作示例 cifproductfield
可在以下位置找到: CIF核心组件 项目。 另请参阅 自定义对话框 AEM核心组件文档的FTP站点。
类别选取器 category-picker
类别选取器可以在组件对话框中使用,其使用方式与产品选取器类似。
以下代码片段可以在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)。
- multiple (true, false) — 启用一个或多个类别的选择(默认值= false)
此外,标准对话框字段属性,如 name
, fieldLabel
,或 fieldDescription
,受支持。
CAUTION
与
cifproductfield
组成 cifcategoryfield
组件还需要 cif.shell.picker
clientlib。 要将clientlib添加到对话框,您可以使用 extraClientlibs
属性。 请参阅 自定义对话框 AEM核心组件文档的FTP站点。CAUTION
从CIF核心组件版本2.0.0开始,支持
id
已移除并替换为 uid
. Adobe建议使用 uid
或 urlPath
作为类别标识符。 Adobe继续支持 id
和 idAndUrlPath
仅适用于使用CIF核心组件1.x版的项目。的完整工作示例 cifcategoryfield
可在以下位置找到: CIF核心组件 项目。
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab