使用隱藏條件

隱藏條件可用於判斷元件資源是否已轉譯。 範本作者設定核心元件時,便屬於此情況 清單元件範本編輯器 並決定停用根據子頁面建立清單的選項。 在「設計」對話方塊中停用此選項會設定屬性,以便在呈現清單元件時,會評估隱藏條件,並且不會顯示顯示子頁面的選項。

概觀

對話方塊可能會變得非常複雜,使用者可以使用許多選項,而他們只能使用他們所能使用的選項的一小部分。 這可能會導致使用者無法承受的使用者介面體驗。

透過使用隱藏條件,管理員、開發人員和超級使用者便能根據一組規則來隱藏資源。 此功能可讓他們決定在作者編輯內容時應該顯示哪些資源。

注意

根據運算式隱藏資源不會取代ACL許可權。 內容仍可編輯,但不會顯示。

實作和使用方式詳細資料

com.adobe.granite.ui.components.FilteringResourceWrapper 負責根據資源的存在和值來篩選資源 granite:hide 屬性,位於要篩選的欄位上。 實作 /libs/cq/gui/components/authoring/dialog/dialog.jsp 包含的執行個體 FilteringResourceWrapper.

實施作業會使用Granite ELResolver API 並新增 cqDesign 透過ExpressionCustomizer的自訂變數。

以下是位於下方的設計節點上的幾個隱藏條件範例。 etc/design 或作為內容原則。

${cqDesign.myProperty}
${!cqDesign.myProperty}
${cqDesign.myProperty == 'someText'}
${cqDesign.myProperty != 'someText'}
${cqDesign.myProperty == true}
${cqDesign.myProperty == true}
${cqDesign.property1 == 'someText' && cqDesign.property2 || cqDesign.property3 != 1 || header.myHeader}

定義隱藏運算式時,請牢記以下事項:

  • 若要有效,應表示找到屬性的範圍(例如, cqDesign.myProperty)。
  • 值為唯讀。
  • 功能(如有需要)應限制在服務提供的一組指定集合中。

範例

在整個AEM和 核心元件 尤其是。 例如,請考慮 列出核心元件 在中實作 wknd教學課程。

使用範本編輯器,範本作者可在「設計」對話方塊中定義清單元件的哪些選項可供頁面作者使用。 例如是否允許清單為靜態清單、子頁面清單、標籤頁面清單等選項。 可啟用或停用。

如果範本作者選擇停用子頁面選項,則會設定設計屬性並評估隱藏條件,導致選項不為頁面作者呈現。

  1. 依預設,頁面作者可以透過選擇選項,使用清單核心元件來使用子頁面建立清單 子頁面.

    清單元件設定

  2. 在清單核心元件的「設計」對話方塊中,範本作者可以選擇選項 停用子項 以防止根據子頁面產生清單的選項顯示給頁面作者。

    清單元件設計對話方塊

  3. 原則節點建立於 /conf/wknd/settings/wcm/policies/wknd/components/list 具有屬性 disableChildren 設定為 true.

    隱藏條件的節點結構

  4. 隱藏條件的定義為 granite:hide 對話方塊屬性節點上的屬性 /libs/core/wcm/components/list/v2/list/cq:dialog/content/items/tabs/items/listSettings/items/columns/items/column/items/listFrom/items/children

    隱藏條件的評估

  5. 的值 disableChildren 從設計設定和運算式中提取 ${cqDesign.disableChildren} 評估至 false,表示選項不會呈現為元件的一部分。

  6. 選項 子頁面 使用清單元件時,不再為頁面作者轉譯。

    已停用具有子選項的清單元件

本頁內容