Button Component (v1) button-component

The Core Component Button component allows for the configuration and display of a button item on a page.

Usage usage

The Core Component Button component allows for the inclusion of a button on a page.

Version and Compatibility version-and-compatibility

The document describes v1 of the Button Component, which was introduced with release 2.5.0 of the Core Components in June 2019.

This document describes v1 of the Button Component.
For details of the current version of the Button Component, see the Button Component document.

Sample Component Output sample-component-output

To experience the Button Component as well as see examples of its configuration options as well as HTML and JSON output, visit the Component Library.

Technical Details technical-details

The latest technical documentation about the Button Component can be found on GitHub.

Further details about developing Core Components can be found in the Core Components developer documentation.

Configure Dialog configure-dialog

The configure dialog allows the content author to define the button and how it will behave and appear for a visitor to the page.

Properties Tab properties-tab

Properties tab of the edit dialog of Button Component

  • Text - The text to display on the button

  • Link - Link to a content page within AEM, an external resource, or an anchor

    • Use the Selection Dialog to choose a path within AEM.
  • Icon - Identifier for displaying an icon in the button

  • ID - This option allows to control the unique identifier of the component in the HTML and in the Data Layer.

    • If left blank, a unique ID is automatically generated for you and can be found by inspecting the resulting page.
    • If an ID is specified, it is the responsibility of the author to make sure that it is unique.
    • Changing the ID can have an impact on CSS, JS and Data Layer tracking.

Accessibility Tab accessibility-tab

Accessibility tab of the edit dialog of Button Component

On the Accessibility tab, values can be set for ARIA accessibility labels for the component.

  • Label - Value of an ARIA label attribute for the component

Design Dialog design-dialog

Styles Tab styles-tab

The Button Component supports the AEM Style System.

Adobe Client Data Layer data-layer

The Button Component supports the Adobe Client Data Layer.