輪播元件

核心元件輪播元件可讓內容作者在可導覽的輪播中呈現內容。

使用狀況

內容作者可使用轉盤元件,將內容整理在旋轉的幻燈片轉盤中。

編輯對話方塊 可讓內容作者建立、命名及排序多張幻燈片,並啟用延遲自動轉換。 使用 設計對話方塊,範本作者可以定義哪些元件可以新增到輪播、啟用或停用自動轉變,以及自訂樣式。

版本和相容性

輪播元件的目前版本是v1,此版本隨2018年10月的核心元件2.2.0版的發佈引入,具體說明見本文。

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

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

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

範例元件輸出

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

技術細節

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

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

深層連結至面板

輪播, 標籤、摺疊式功能表元件 支援直接連結至元件中的面板。

若要這麼做:

  1. 使用檢視含有元件的頁面 檢視已發佈 頁面編輯器中的選項。
  2. Inspect頁面內容並識別面板的ID。
    • 例如 id="carousel-bfe4fa6647-item-47f1a7ca67-tabpanel"
  3. 此ID會成為您可以使用雜湊(#)。
    • 例如 https://wknd.site/content/wknd/language-masters/en/magazine/western-australia.html#carousel-bfe4fa6647-item-47f1a7ca67-tabpanel

導覽至將面板ID作為錨點的URL,瀏覽器會直接捲動至特定元件並顯示指定的面板。 如果面板設定為預設不顯示,則會自動捲動至。

編輯對話方塊

內容作者可以使用「編輯」對話方塊來新增、重新命名和重新排列幻燈片,以及定義自動轉變設定。

專案標籤

輪播元件之「編輯」對話方塊的「專案」索引標籤

使用 新增 按鈕來開啟元件選擇器,選擇要新增為索引標籤的元件。 新增後,一個專案會新增到清單中,包含以下欄:

  • 圖示 — 標籤的元件型別圖示,用於方便在清單中識別。 將滑鼠移到上方以檢視完整的元件名稱作為工具提示。
  • 說明 — 用作索引標籤文字的說明,預設為為索引標籤選取的元件名稱。
  • 刪除 — 點選或按一下以從索引標籤元件中刪除索引標籤。
  • 重新排序 — 點選或按一下並拖曳以排序標籤。
秘訣

如果減小頁面檢視區,使編輯對話方塊變成全熒幕, 新增 按鈕將會隱藏。 元件仍可透過以下方式新增至轉盤元件 從元件瀏覽器拖曳並放置在頁面編輯器的轉盤元件上.

屬性標籤

輪播元件「編輯」對話方塊的「屬性」索引標籤

屬性 索引標籤上,內容作者可以設定投影片以自動切換。

  • 使用中的專案 — 內容作者可以定義載入頁面時處於作用中狀態的索引標籤。
  • 自動切換投影片 — 啟動時,元件會在指定的延遲之後自動前進到下一張幻燈片。
  • 切換延遲 — 選取「自動切換投影片」時,此值可用來定義切換之間的延遲(以毫秒為單位)。
  • 停用暫留時自動暫停 — 時間 自動切換投影片 選取時,只要游標暫留在輪播上,輪播轉變就會自動暫停。 選取此選項,轉變將不會暫停。
  • ID — 此選項可讓您控制HTML和中的元件唯一識別碼 資料層.
    • 如果保留為空白,系統會自動為您產生唯一ID,並可透過檢查結果頁面找到該ID。
    • 若指定ID,作者應負責確認該ID是唯一的。
    • 變更ID會對CSS、JS和資料層追蹤造成影響。
注意

幻燈片前進控制項在中時未啟用 編輯 模式。 使用 預覽 模式檢視已發佈 可像已發佈內容的讀者那樣與輪播互動的選項。

自動前進功能在中時未啟用 編輯 模式。 使用 檢視已發佈 選項可讓您像已發佈內容的讀者那樣檢視自動前進功能。

協助工具標籤

輪播元件「編輯」對話方塊的「協助工具」索引標籤

協助工具 標籤,可設定的值 ARIA協助工具 元件的標籤。

  • 標籤 — 輪播的aria-label屬性值,可描述輪播的內容
  • 上一個 — 輪播導覽的上一個按鈕標籤的aria-label屬性值
  • 下一個 — 輪播導覽的下一個按鈕標籤的aria-label屬性值
  • 播放 — 輪播導覽的播放按鈕標籤的aria-label屬性值
  • 暫停 — 輪播導覽的暫停按鈕標籤的aria-label屬性值
  • 標籤清單 — 輪播導覽的專案清單標籤的aria-label屬性值
  • 將專案的aria標籤設定為其標題 — 如果勾選,此選項會自動將輪播專案標題設定為其aria-label說明。

選取面板

內容作者可以使用 選取面板 元件工具列上的選項,以變更為不同的幻燈片進行編輯,以及輕鬆地重新排列幻燈片的順序。

選取面板圖示

選取 選取面板 選項時,已設定的投影片會顯示為下拉式清單。

  • 清單會依指派給幻燈片的順序排列,並會反映在編號中。
  • 首先顯示幻燈片的元件型別,然後是較細字型的幻燈片說明。

選取面板

  • 在下拉式清單中點選或按一下某個專案,會在編輯器中將檢視切換到該幻燈片。
  • 可以使用拖曳操作框就地重新排序幻燈片。

設計對話方塊

範本作者可以使用「設計」對話方塊來定義哪些元件可以新增為幻燈片至輪盤元件,以及定義自動切換預設值和哪些自訂樣式可供內容作者使用。

屬性標籤

屬性 tab鍵可在內容作者新增輪播元件至頁面時,用來定義投影片過渡的預設設定。

輪播元件的「設計」對話方塊

  • 自動切換投影片 — 定義內容作者新增輪播元件至頁面時,是否預設啟用自動將輪播前進到下一張幻燈片的選項。
  • 在控制元素前加上 — 選取後,控制元素將放在輪播專案前面,以改善協助工具。

允許的元件索引標籤

允許的元件 tab可用來定義哪些元件可由內容作者新增為幻燈片至輪播元件。

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

樣式索引標籤

輪播元件支援AEM 樣式系統.

Adobe使用者端資料層

輪播元件支援 Adobe使用者端資料層。

本頁內容