Getting started

InstallUsageGuidelinesContributeRelease

Foundation

Navigation

LinkLink Button

Link

Links allow user to navigate to another in-app page or external URLs.

#

#

When navigating to a page in an application powered by React Router, Link component from React Router is used instead of <a> tag to avoid a full page reload.

Note that you still set path via a href prop, not to, as you would when using React Router's Link component directly.

When an absolute URL is provided, it's treated as an external link. External links open in a new tab.

#

#

  • When navigating to a different page within the app that doesn't require user input.
  • When navigating to an external URL.

#

  • If navigating to a different page that requires user input, use a button instead.
  • If clicking a link performs an action while staying on the same page.

#

#

NameDefaultDescription
href

string

Link URL.

children

ReactNode

Link text.

On this page

  • Example
  • Usage
  • Internal links
  • External links
  • Guidelines
  • When to use
  • When not to use
  • Content
  • Props