Buttons

Buttons are interactive elements that create clickable links to external resources. They're perfect for directing users to documentation, downloads, or any external URL. Each button can include an icon and opens links in a new tab for better user experience.

Properties

title

string required

The text displayed on the button. This is the primary label that users will see and click on.

href

string required

The URL that the button links to. When clicked, this will open in a new tab with proper security attributes (rel="noopener noreferrer").

icon

string optional

An icon to display alongside the button text. Can be either a path to a local Scalar icon or a URL to an external icon. If not provided, the button will display only text.

icon-dark

string optional

An icon to display alongside the button text in dark mode. If not provided, the specified icon will be shown in both modes.

Examples

Basic Button

<scalar-button title="View Documentation" href="https://docs.scalar.com"> </scalar-button>

<scalar-button
  title="View Documentation"
  href="https://docs.scalar.com">
</scalar-button>

::scalar-button{title="View Documentation" href="https://docs.scalar.com"}

::scalar-button{title="View Documentation" href="https://docs.scalar.com"}

Button with Icon

<scalar-button
  title="Download SDK"
  href="https://github.com/scalar/scalar"
  icon="phosphor/regular/house">
</scalar-button>

::scalar-button{ title="Download SDK" href="https://github.com/scalar/scalar" icon="phosphor/regular/house"}

::scalar-button{ title="Download SDK" href="https://github.com/scalar/scalar" icon="phosphor/regular/house"}

Button with External Icon

<scalar-button
  title="Visit Website"
  href="https://scalar.com"
  icon="https://cdn.scalar.com/images/logo-light.svg"
  icon-dark="https://cdn.scalar.com/images/logo-dark.svg">
</scalar-button>

::scalar-button{ title="Visit Website" href="https://scalar.com" icon="https://cdn.scalar.com/images/logo-light.svg" icon-dark="https://cdn.scalar.com/images/logo-dark.svg"}

::scalar-button{ title="Visit Website" href="https://scalar.com" icon="https://cdn.scalar.com/images/logo-light.svg" icon-dark="https://cdn.scalar.com/images/logo-dark.svg"}