按鈕元件 button-component

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

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

用途 usage

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

版本和相容性 version-and-compatibility

按鈕元件的目前版本為 v2,此版本於 2022 年 2 月隨著核心元件 2.18.0 版發行導入,詳情請參閱本文件。

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

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

如需核心元件版本和發行版本的進一步詳細資訊,請參閱核心元件版本文件。

範例元件輸出 sample-component-output

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

技術詳細資訊 technical-details

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

如需開發「核心元件」的進一步詳細資訊,請參閱核心元件開發人員文件

設定對話框 configure-dialog

設定對話框可讓內容作者定義按鈕,以及其對頁面訪客的行為與顯示方式。

屬性索引標籤 properties-tab

按鈕元件編輯對話框的屬性索引標籤

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

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

    • 使用​ 選取對話框 ​在 AEM 中選擇路徑。
  • 在新索引標籤中開啟連結 - 勾選後,該連結將在新的瀏覽器索引標籤中開啟。

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

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

    • 如果留空,則會自動產生唯一識別碼,您可以透過檢查得出的頁面找到該 ID。
    • 若已指定 ID,則作者應確保其為唯一識別碼。
    • 變更該 ID 會對 CSS、JS 和「資料層」追蹤造成影響。

協助工具索引標籤 accessibility-tab

按鈕元件編輯對話框的協助工具索引標籤

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

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

樣式索引標籤 styles-tab-edit

按鈕元件編輯對話框的樣式索引標籤

按鈕元件支援 AEM 樣式系統

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

元件樣式必須在設計對話框中設定,才能使用該下拉式清單。

設計對話框 design-dialog

樣式索引標籤 styles-tab

按鈕元件支援 AEM 樣式系統

Adobe Client Data Layer data-layer

「按鈕元件」支援 Adobe Client Data Layer。

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