Skip to content
Skip to content

Link

The Link component allows you to customize anchor tags with theme colors and typography styles.

Introduction

The Link component represents the HTML <a> element. It accepts the same props as the Typography component, as well as the system props.

<Link />

Playground

Component

After installation, you can start building with this component using the following basic elements:

import Link from '@mui/joy/Link';

export default function MyApp() {
  return <Link>Hello world!</Link>;
}

As a button

To use the Link as a button, assign the button value to the component prop. It's useful doing it in two main situations:

  1. The link doesn't have a meaningful href.
  2. The design looks more a link rather than a button.
<Link
  component="button"
  onClick={() => {
    // ...process something
  }}
>
  Do something
</Link>

With a typography

Link can be used as a child of the Typography component. In that case, the link component will inherit the typographic level scale from its typography parent, unless a value for the level prop is specified.

Heading

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore Magna Aliqua. Maecenas sed enim ut sem viverra aliquet eget.

With a card

Using the Link component as a card title, with the overlay prop, ensures proper accessibility when the whole card is clickable.

Components that spark joy!

Click the and TAB to test the focus

Security

When using target="_blank" with links, it's recommended to always set rel="noopener" or rel="noreferrer" when linking to a third-party content.

  • rel="noopener" prevents the new page from being able to access the window.opener property and ensures it runs in a separate process. Without this, the target page can potentially redirect your page to a malicious URL.
  • rel="noreferrer" has the same effect, but also prevents the Referer header from being sent to a new page. ⚠️ Removing the referrer header will affect analytics.

Accessibility

Here are a few tips for ensuring an accessible link component, based on WAI-ARIA.

  • Copywriting: Avoid generic words as call to action, such as "click here" or "go to". Instead, use descriptive texts.
  • Design: For a good user experience, links should stand out from the text on the page. Keeping the default underline="always" behavior is a safe bet.
  • Href: If a link doesn't have a meaningful href, it should be rendered using a <button> element.

Third-party routing library

Here's how you can use the link component with libraries that also provide their version of it.

Next.js

Here is an example with the Link component of Next.js:

import NextLink from 'next/link';
import Link from '@mui/joy/Link';

<NextLink href="/docs" passHref>
  <Link>Read doc</Link>
</NextLink>;

React Router

Here is an example with the Link component of React Router:

import { Link as RouterLink } from 'react-router-dom';
import Link from '@mui/joy/Link';

<Link component={RouterLink} to="/docs">
  Read doc
</Link>;

Common examples

Examples showcasing how to compose designs with the Link component and others as decorators.

API

See the documentation below for a complete reference to all of the props and classes available to the components mentioned here.