Hyperlink

minimal usage

Show editable code example

Any Paragon component or export may be added to the code example.

<Hyperlink destination="https://www.edx.org">
  edX.org
</Hyperlink>

<Hyperlink destination="https://www.edx.org">
  edX.org
</Hyperlink>

with blank target

Show editable code example

Any Paragon component or export may be added to the code example.

<Hyperlink destination="https://www.edx.org" target="_blank">
  edX.org
</Hyperlink>

<Hyperlink destination="https://www.edx.org" target="_blank">
  edX.org
</Hyperlink>

blank target without Icon

Show editable code example

Any Paragon component or export may be added to the code example.

<Hyperlink destination="https://www.edx.org" target="_blank" showLaunchIcon={false}>
  edX.org
</Hyperlink>

<Hyperlink destination="https://www.edx.org" target="_blank" showLaunchIcon={false}>
  edX.org
</Hyperlink>

with onClick

Show editable code example

Any Paragon component or export may be added to the code example.

<Hyperlink
  destination="https://www.edx.org"
  target="_blank"
  onClick={e => {
    e.preventDefault();
    console.log('click');
  }}
>
  edX.org
</Hyperlink>

<Hyperlink
  destination="https://www.edx.org"
  target="_blank"
  onClick={e => {
    e.preventDefault();
    console.log('click');
  }}
>
  edX.org
</Hyperlink>

with icon

Show editable code example

Any Paragon component or export may be added to the code example.

<Hyperlink destination="https://www.edx.org">
  <Icon
    id="SampleIcon"
    src={Add}
    className="fa fa-book"
    screenReaderText="Visit edX Home"
  />
</Hyperlink>

<Hyperlink destination="https://www.edx.org">
  <Icon
    id="SampleIcon"
    src={Add}
    className="fa fa-book"
    screenReaderText="Visit edX Home"
  />
</Hyperlink>

color variants

Show editable code example

Any Paragon component or export may be added to the code example.

<div className="d-flex flex-column">
    <Hyperlink destination="https://www.edx.org">
      Default
    </Hyperlink>
    
    <Hyperlink variant="muted" destination="https://www.edx.org">
      Muted
    </Hyperlink>
    
    <Hyperlink variant="brand" destination="https://www.edx.org">
      Brand
    </Hyperlink>
</div>

<div className="d-flex flex-column">
    <Hyperlink destination="https://www.edx.org">
      Default
    </Hyperlink>
    
    <Hyperlink variant="muted" destination="https://www.edx.org">
      Muted
    </Hyperlink>
    
    <Hyperlink variant="brand" destination="https://www.edx.org">
      Brand
    </Hyperlink>
</div>

link variants

Show editable code example

Any Paragon component or export may be added to the code example.

<div className="row">
  <div className="col-2">
    <Hyperlink destination="https://www.edx.org">
      Standalone
    </Hyperlink>
  </div>
    
  <div className="col-2">
    <Hyperlink isInline destination="https://www.edx.org">
      Inline
    </Hyperlink>
  </div>
</div>

<div className="row">
  <div className="col-2">
    <Hyperlink destination="https://www.edx.org">
      Standalone
    </Hyperlink>
  </div>
    
  <div className="col-2">
    <Hyperlink isInline destination="https://www.edx.org">
      Inline
    </Hyperlink>
  </div>
</div>

Props API#

Hyperlink Props API

destination string Required
specifies the URL
children node Required
Content of the hyperlink
className string
Custom class names for the hyperlink
target enum'_blank' | '_self'
specifies where the link should open. The default behavior is _self, which means that the URL will be loaded into the same browsing context as the current one. If the target is _blank (opening a new window) rel='noopener' will be added to the anchor tag to prevent any potential reverse tabnabbing attack.
Default'_self'
onClick func
specifies the callback function when the link is clicked
Default() => {}
externalLinkAlternativeText string
Alt text for the icon indicating that this link opens in a new tab, if target="blank". e.g. ("in a new tab")
Default'in a new tab'
externalLinkTitle string
Tooltip text for the "opens in new tab" icon, if target="blank". e.g. ("Opens in a new tab").
Default'Opens in a new tab'
variant enum'default' | 'muted' | 'brand'
type of hyperlink
Default'default'
isInline bool
Display the link with an underline. By default, it is only underlined on hover.
Defaultfalse
showLaunchIcon bool
specify if we need to show launch Icon. By default, it will be visible.
Defaulttrue

Usage Insights#

Hyperlink

Project Name	Paragon Version	Instance Count
edx-platform	2.6.4	2
frontend-app-account	22.9.0	10
frontend-app-admin-portal	21.13.1	50
frontend-app-authn	22.10.0	23
frontend-app-communications	22.7.0	1
frontend-app-course-authoring	22.8.1	54
learning_assistant	22.8.1	2
live	22.8.1	2
ora_settings	22.8.1	1
proctoring	22.8.1	1
xpert_unit_summary	22.8.1	2
frontend-app-discussions	22.7.0	3
frontend-app-ecommerce	20.46.3	3
frontend-app-enterprise-public-catalog	21.13.1	2
frontend-app-gradebook	22.8.1	2
frontend-app-learner-dashboard	22.9.0	6
frontend-app-learner-portal-enterprise	21.13.1	27
frontend-app-learner-record	22.10.0	9
frontend-app-learning	22.8.1	27
frontend-app-ora-grading	21.11.3	5
frontend-app-payment	22.9.0	8
frontend-app-profile	22.10.0	2
frontend-app-publisher	21.13.1	6
frontend-app-support-tools	21.13.1	17
frontend-component-header-edx	21.13.1	2
frontend-lib-special-exams	22.7.0	5
prospectus	20.46.2	5
studio-frontend	3.4.8	4

Edit this page Leave feedback

Paragon Design System

Theme

Hyperlink

minimal usage

with blank target

blank target without Icon

with onClick

with icon

color variants

link variants

Props API#

Usage Insights#

Hyperlink

All components (A-Z)

Theme

Hyperlink

minimal usage#

with blank target#

blank target without Icon#

with onClick#

with icon#

color variants#

link variants#

Props API#

Usage Insights#

Hyperlink

All components (A-Z)

minimal usage

with blank target

blank target without Icon

with onClick

with icon

color variants

link variants