文件AEM核心元件指南

按鈕元件

最後更新: 2025年6月24日
  • 主題:
  • 核心組件

建立對象:

  • 開發人員
  • 管理員
  • 使用者

核心元件按鈕元件允許在頁面上設定和顯示按鈕專案。

秘訣
您是否考慮過適用於 AEM 的 Edge Delivery Services?
現有的專案可以繼續使用本文件中所述的方法。然而,針對新專案,Adobe 建議採用 Edge Delivery Services。

使用情況

利用核心元件按鈕元件,可在頁面上包含按鈕。

  • 可在設定對話方塊中選取按鈕的屬性。
  • 按鈕元件的樣式可在設計對話方塊中定義。

版本和相容性

Button元件的目前版本是v2,此版本隨2022年2月的核心元件發行版本2.18.0的發佈引入,說明見本文。

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

元件版本AEM 6.4AEM 6.5AEM 6.5 LTSAEM as a Cloud Service
v2-相容相容相容
v1相容相容-相容

如需核心元件版本的詳細資訊,請參閱檔案核心元件版本。

範例元件輸出

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

技術細節

在GitHub🔗上可找到有關按鈕元件的最新技術檔案。

在核心元件開發人員檔案中可找到有關開發核心元件的進一步詳細資料。

設定對話方塊

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

屬性標籤

按鈕元件 之編輯對話方塊的屬性標籤

  • 文字 — 按鈕上顯示的文字

  • 連結 — 連結至AEM中的內容頁面、外部資源或錨點

    • 使用​ 選取範圍對話方塊 ​在AEM中選擇路徑。
  • 在新標籤中開啟連結 — 如果勾選,將在新的瀏覽器標籤中開啟連結。

  • 圖示 — 在按鈕中顯示圖示的識別碼

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

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

協助工具標籤

按鈕元件 之編輯對話方塊的協助工具標籤

在​ 協助工具 ​標籤上,可以為元件設定ARIA協助工具標籤的值。

  • 標籤 — 元件的ARIA標籤屬性值

樣式索引標籤

按鈕元件 之編輯對話方塊的樣式索引標籤

按鈕元件支援AEM 樣式系統。。

使用下拉式清單,選取要套用至元件的樣式。 在「編輯」對話方塊中所做的選取與從元件工具列中選擇的選取具有相同的效果。

必須在設計對話方塊中為此元件設定樣式,以便下拉式功能表可用。

設計對話方塊

樣式索引標籤

按鈕元件支援AEM 樣式系統。

Adobe Client Data Layer

按鈕元件支援Adobe使用者端資料層。

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