Link Button
Link Button is similar to a button, however acts as a link to navigate users between pages.
Overview
<LinkButton href="#">Link Button</LinkButton>
Import
Import the component from @faststore/ui
import { LinkButton } from '@faststore/ui'
Import Styles into your FastStore project
To apply the styles of this component in your FastStore project, import the following into your stylesheet:
@import '@faststore/ui/src/components/molecules/LinkButton/styles.scss';
Follow the instructions in the Importing FastStore UI component styles tutorial.
Usage
<LinkButton href="#">Link Button</LinkButton>
Props
The LinkButton
component supports all attributes supported by the tag a
.
Besides those attributes, the following props are also supported Button Props:
Name | Type | Description | Default |
---|---|---|---|
testId | string | ID to find this component in testing tools (e.g.: cypress, testing library, and jest). | fs-link-button |
variant | 'primary' | 'secondary' | 'tertiary' | Specifies the component color variant. | primary |
size | 'small' | 'regular' | Specifies the size variant. | regular |
inverse | boolean | Defines the use of inverted colors. | |
disabled | boolean | Specifies that this button should be disabled. | |
icon | ReactNode | A React component that will be rendered as an icon. | |
iconPosition | 'left' | 'right' | Specifies where the icon should be positioned. |
Design Tokens
This component inherits Button design tokens.
Nested Elements
Icon
Variants
This component inherits Button variants.
Primary
<LinkButton href="#" variant="primary">
Link Button
</LinkButton>
Primary Inverse
<LinkButton href="#" variant="primary" inverse>
Link Button
</LinkButton>
Secondary
<LinkButton href="#" variant="secondary">
Link Button
</LinkButton>
Secondary Inverse
<LinkButton href="#" variant="secondary" inverse>
Link Button
</LinkButton>
Tertiary
<LinkButton href="#" variant="tertiary">
Link Button
</LinkButton>
Tertiary Inverse
<LinkButton href="#" variant="tertiary" inverse>
Link Button
</LinkButton>
Disabled
<LinkButton href="#" disabled>
Link Button
</LinkButton>
Small
<LinkButton variant="primary" size="small">
Link Button
</LinkButton>
Customization
For further customization, you can use the following data attributes:
data-fs-link-button
This component inherits Button CSS selectors and styles.
Best Practices
✅ Do's
- Use the
LinkButton
only to navigate the user between store pages. For general purposes, use the standard Button.