Link

Pega branded actionable text.

Published Last updated: 3.6.0 Change log Github NPM
Twig Usage 
  {% include "@bolt-components-link/link.twig" with {
  text: "This is a link",
  url: "https://pega.com"
} only %}
Schema
Note: when assigning component props as HTML attributes on a web component, make sure to use kebab-case.
Prop Name Description Type Default Value Option(s)
attributes

A Drupal-style attributes object with extra attributes to append to this component.

 object —
  • —
text

Renderable content (i.e. a string, render array, or included pattern) for the link.

 string , object , array —
  • —
url

Optional. Contains a URL that the chip points to. When URL is present, tag changes to a, otherwise tag would be span.

 string —
  • —
target

A valid HTML target attribute to modify the behavior when clicking this element. Only valid when "url" is also present.

 string _self
  • _blank , _self , _parent , _top , framename
type

Determines the button tag type for semantic buttons

 string button
  • button , submit , reset
display

Display either an inline link or flex link (icons can hang on either side).

 string inline
  • inline , flex , block
valign

Controls the vertical alignment of text and icon.

 string center
  • center or start
is_headline

Whether this link should get special headline styling treatment.

 boolean —
  • —
icon

Icon data as expected by the icon component. Accepts an additional position prop that determines placement within the link.

 object —
    • position

      Where to position the icon within the button

      • before or after
    • attributes

      A Drupal-style attributes object with extra attributes to append to this component.

      • —
    • name

      Icon name

      • —
    • background

      Customizes the background that's displayed behind the SVG icon itself. Choosing any option other than none will automatically add a bit of space around the SVG so the background has the necessary space. Note, this option is now available to icons of all sizes!

      • none , circle , square
    • size

      Controls the size of the icon. Each size is set to a specific pixel value: 16px, 24px, 32px, and 38px. However, this prop is optional. When no size is specified, the icon is expected to act as an inline icon, which will grow or shrink depending on the font-size of its parent container.

      • small , medium , large , xlarge
    • color

      Icon color palette. Picking an option other than auto will override the default colors based on the color theme is placed within.

      • auto , teal , navy , yellow , orange , gray , pink , berry , wine , violet
on_click

When used with on_click_target, an event to fire on the targeted elements when this element is clicked. When used without on_click_target, arbitrary javascript to execute when this element is clicked.

 string —
  • —
on_click_target

Requires on_click. A CSS selector for elements that the on_click event will fire on when this element is clicked.

 string —
  • —
onClick
(deprecated)

Use on_click instead.

 — —
  • —
onClickTarget
(deprecated)

Use on_click_target instead.

 — —
  • —
href
(deprecated)

Use url instead.

 — —
  • —
isHeadline
(deprecated)

Use is_headline instead.

 — —
  • —
Install Install 
  npm install @bolt/components-link
Dependencies @bolt/components-icon @bolt/core-v3.x @bolt/lazy-queue