容器元件 container-component

核心元件容器元件可讓您在頁面上為多個其他元件建立容器。

使用狀況 usage

核心元件容器元件可在頁面上為多個其他元件建立容器,並可用於分組其他元件及套用通用樣式或版面。

版本和相容性 version-and-compatibility

容器元件的目前版本是v1,此版本隨2019年6月的核心元件2.5.0版的發佈引入,具體說明見本文。

下表詳細說明元件的所有支援版本、與元件版本相容的AEM版本,以及舊版檔案的連結。

元件版本
AEM 6.4
AEM 6.5
AEM as a Cloud Service
v1
相容於
版本2.17.4 和先前的
相容
相容

如需核心元件版本和發行版本的詳細資訊,請參閱檔案 核心元件版本.

範例元件輸出 sample-component-output

若要體驗容器元件並檢視其設定選項範例以及HTML和JSON輸出,請造訪 元件資料庫.

技術細節 technical-details

有關容器元件的最新技術檔案 可在GitHub上找到.

有關開發核心元件的進一步詳細資訊,請參閱 核心元件開發人員檔案.

設定對話方塊 configure-dialog

「設定」對話方塊可讓內容作者定義容器專案,以及對於頁面的訪客它會如何表現和顯示。

容器元件的「編輯」對話方塊

  • 版面 — 此選項會定義容器元件的行為或配置行為。

    • 簡單 — 將容器定義為簡單的元件集合
    • 回應式格線 — 將容器定義為 AEM回應式佈局
  • 背景顏色 — 定義為自由格式的RGB值,或使用檢色器、 視設定而定

  • 背景影像 — 定義容器的背景顏色, 視設定而定

  • ID — 此選項可讓您控制HTML和中的元件唯一識別碼 資料層.

    • 如果保留為空白,系統會自動為您產生唯一ID,並可透過檢查結果頁面找到該ID。
    • 若指定ID,作者應負責確認該ID是唯一的。
    • 變更ID會對CSS、JS和資料層追蹤造成影響。

設計對話方塊 design-dialog

「設計」對話方塊可讓範本作者定義哪些選項可供使用容器元件的內容作者使用。

允許的元件索引標籤 allowed-components-tab

允許的元件 tab可用來定義哪些元件可由內容作者以專案形式新增至容器元件。

「允許的元件」標籤的功能與相同名稱的標籤的功能相同,當 在範本編輯器中定義配置容器的原則和屬性。

預設元件標籤 default-components-tab

「預設元件」索引標籤可用來定義在特定資產型別拖放到容器上時,要新增至元件的元件,類似於 如何在頁面範本上定義預設元件.

回應式設定標籤 responsive-settings-tab

容器元件之設計對話方塊的回應式設定標籤

  • — 定義產生之容器的格線中的欄數。

背景索引標籤 background-tab

容器元件之「設計」對話方塊的「背景」標籤

  • 背景影像

    • 啟用背景影像 — 選取此選項可讓內容作者定義容器的背景影像。
  • 背景色彩

    • 啟用背景顏色 — 選取此選項可讓內容作者定義容器的背景顏色。
    • 僅限色票 — 選取此選項,僅允許內容作者從預先定義的色票中選取容器背景顏色。
      • 僅適用於 啟用背景顏色 已選取
  • 允許的色票 — 定義內容作者可從中選擇容器背景顏色的預定義顏色

    • 使用 新增 按鈕以新增預先定義的色票。 新增後,一個專案會新增到清單中,包含以下欄:
    • — 透過RGB值手動定義顏色
      • 點選或按一下檢色器,即可調整個別RGB值或定義十六進位值,更輕鬆地選取顏色。
    • 刪除 — 點選或按一下以刪除色票。
    • 重新排列 — 點選或按一下並拖曳以重新排列色票。

樣式索引標籤 styles-tab

容器元件支援AEM 樣式系統.

recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c