Summary

Add a built-in, accessible Button macro in Confluence Cloud. The existing Smart Button macro offers limited functionality and accessibility. The new macro should use a native <button> element with ARIA support, be fully keyboard-operable, and accessible to screen readers. It should allow customizable visible labels, optional color styling, and support specifying link targets with clear distinction between link and action semantics. This will ensure consistent, usable, and accessible call-to-action elements for all users.

Actual Results

Confluence Cloud currently lacks a native Button macro that functions as a standard HTML button. The existing Smart button lacks key features and fails accessibility standards. It does not consistently support keyboard navigation, and screen readers may not recognize it as a button, limiting usability for assistive technology users. Additionally, visual customization options are limited, hindering compliance with design and accessibility requirements.

Expected Results

Adding a built-in accessible Button macro should enable authors to create consistent, usable, and accessible call-to-action elements.

Please implement the following specifications ->

• Use a native <button> element with ARIA support, including an aria-label attribute for descriptive text.
• Ensure full keyboard operability, allowing focus via the Tab key and activation through the Enter or Space keys.
• Make the button accessible to screen readers, announced as a button with the correct label.
• Support customizable visible labels and optional color styling to enhance visual clarity.
• Provide optional color styling to ensure visual distinction and design consistency.
• Enable specification of link targets (such as page URLs or anchors) and clearly differentiate between link and action semantics.

Additional Context

The lack of an accessible button macro requires users to rely on styled text or linked images, which are not semantic and may cause accessibility challenges. The implementation of this feature will significantly enhance usability, accessibility, and consistency across Confluence Cloud. This aligns with Atlassian's commitment to inclusive design and accessibility standards.