AEM內容與Commerce編寫選擇器 cif-pickers

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
商務整合框架

建立對象：

管理員
開發人員

AEM Content & Commerce Authoring提供一套製作工具，可協助AEM作者和行銷人員有效使用商務產品資料和目錄。產品選擇器和類別選擇器是CIF附加元件的一部分，由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"/>

產品欄位可讓您透過不同檢視導覽至使用者想要選取的產品。依預設，產品欄位會傳回產品的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僅繼續為使用CIF核心元件1.x版的專案支援id。

在CIF核心元件專案中可以找到cifproductfield的完整工作範例。另請參閱AEM核心元件檔案的自訂對話方塊。

類別選取器 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核心元件檔案的自訂對話方塊。

CAUTION

從CIF核心元件2.0.0版開始，已移除對id的支援，並取代為uid。 Adobe建議使用uid或urlPath作為類別識別碼。 Adobe僅繼續為使用CIF核心元件1.x版的專案支援id和idAndUrlPath。

在CIF核心元件專案中可以找到cifcategoryfield的完整工作範例。

recommendation-more-help

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