Alternative for deprecated <Button appearance="link">?

Hi there,

as I saw that there are deprecated Buttons (https://atlassian.design/components/button/button-legacy/examples) and want to switch the new ones, I’ve noticed that there is no alternative to the link appearance (https://atlassian.design/components/button/examples).

The so called LinkButton has no onClick (beside the missing link style). The subtle appearance has strange hover effects

We (and Atlassian itself) use the style of the legacy button with link appearance for example as “Close” trigger in a dialog.

Any thoughts?
Cheers,
paul

The Cancel action is handled by subtle buttons: https://atlassian.design/components/button/examples#subtle The hover effects are intentional. If you want something that looks like the deprecated Link button, it would just be a Link: https://atlassian.design/components/link/examples

Hi Aaron,

thanks for your response.

Both of them do not work for me:

  • subtle: uncommon hover effect (refer to “Cancel” in create issue or other places in Jira)
  • Link: no onClick property

For me this is just missing in the new button component!

Ah, I must have been looking at the Confluence Cancel button. There is has the hover effect. So does the Close button in the Jira dialog. I’d guess they’ll migrate the Jira Cancel ones eventually.

Seems like you want something that goes counter to their design system, so it seems unlikely to be added. Not sure when they’ll actually remove the legacy versions.

Hey @ppasler,

I’ve flagged your question with the Atlassian Design Team, and they got back to me to say

… I think I have answers for both:
• There is definitely an onClick prop for the new link button.
• As for matching the old styling of a “subtle link” button, where on hover you see an underline, we moved away from that pattern because it presented accessibility issues. So the new styling of a link button where you get a background color change on hover should be what’s used. It’s what is currently used in Jira.

I had a bit of a deeper look, and it seems like onClick for the link button is documented here.

As for the styling of the button in Jira, could you be looking at an old issue experience / old issue view somewhere?

I hope this helps explain why we’re moving to the new style!
If this has helped, please mark it as the solution.
If you’re still stuck or are looking for further explanation please let me know.

Cheers!
Mel

1 Like

Hi @mpaisley ,

Thank you for your response and for clarifying!

I didn’t realize there’s an onClick function in the LinkButton - I must have missed it, especially with the href property being required.

What’s the recommended appearance to style a ‘Close’ or ‘Cancel’ button in a dialog, to meet the Atlassian design guidelines?

Cheers,
paul

If it helps, I missed it to the first time as well :sweat_smile:

From what I can see either the subtle link button Link Button, Subtle Button or Default Button are being used. For example, here on the create status dialog the Subtle style is being used:

Screen Recording 2024-12-10 at 4.56.30 PM

According to the usage guidelines, there isn’t a recommendation other than making it clear that one of the buttons is a primary call to action (and of course, the recommendation is not to use the legacy button for accessibility reasons).

Hope that makes sense?
Mel

Hi Mel,

thank you, this totally makes sense!

Cheers,
paul