Buttons are clickable elements that are used to perform an action.
Usage
Do’s
Use a Button to enable actions or decisions that are important to a user, such as:
submitting a form;
confirming a change;
triggering a new element to appear on the page;
specifying a new or next step in a process.
Button can be used for actions, like ‘Load more’, ‘Filters’ etc.
Dont’s
Do not use buttons as navigational elements. Instead, use links when the desired action is to take the user to a new page (with the exception of the back and forward buttons).
Do not style Buttons as links.
Do not use leading and trailing icons at the same time.
Anatomy
Item | Component type | Content type | Notes | |
---|---|---|---|---|
1 | Leading icon | SVG file | OPTIONAL | |
2 | Trailing icon | SVG file | OPTIONAL | |
3 | Button label | Typography | Text | MANDATORY |
Visual style
Sizes
Buttons come with two sizes: large and small.
States
Buttons have five states that define their appearance: Default, Hover, Focus, Active and Disabled.
Variants
Primary Large Icon Text http://phx-husky.s3-website.eu-central-1.amazonaws.com/master/ds/latest/iframe.html?id=components-button-variations--primary-large-icon-text&args=&viewMode=story
Primary Large Icon http://phx-husky.s3-website.eu-central-1.amazonaws.com/master/ds/latest/iframe.html?id=components-button-variations--primary-large-icon&args=&viewMode=story
Primary Small Icon Text http://phx-husky.s3-website.eu-central-1.amazonaws.com/master/ds/latest/iframe.html?id=components-button-variations--primary-small-icon-text&args=&viewMode=story
Primary Small Icon http://phx-husky.s3-website.eu-central-1.amazonaws.com/master/ds/latest/iframe.html?id=components-button-variations--primary-small-icon&args=&viewMode=story
Secondary Large Icon Text http://phx-husky.s3-website.eu-central-1.amazonaws.com/master/ds/latest/iframe.html?id=components-button-variations--secondary-large-icon-text&args=&viewMode=story
Secondary Large Icon http://phx-husky.s3-website.eu-central-1.amazonaws.com/master/ds/latest/iframe.html?id=components-button-variations--secondary-large-icon&args=&viewMode=story
Secondary Small Icon Text http://phx-husky.s3-website.eu-central-1.amazonaws.com/master/ds/latest/iframe.html?id=components-button-variations--secondary-small-icon-text&args=&viewMode=story
Secondary Small Icon http://phx-husky.s3-website.eu-central-1.amazonaws.com/master/ds/latest/iframe.html?id=components-button-variations--secondary-small-icon&args=&viewMode=story
Subtle Large Icon Text http://phx-husky.s3-website.eu-central-1.amazonaws.com/master/ds/latest/iframe.html?id=components-button-variations--subtle-large-icon-text&args=&viewMode=story
Subtle Large Icon http://phx-husky.s3-website.eu-central-1.amazonaws.com/master/ds/latest/iframe.html?id=components-button-variations--subtle-large-icon&args=&viewMode=story
Subtle Small Icon Text http://phx-husky.s3-website.eu-central-1.amazonaws.com/master/ds/latest/iframe.html?id=components-button-variations--subtle-small-icon-text&args=&viewMode=story
Subtle Small Icon http://phx-husky.s3-website.eu-central-1.amazonaws.com/master/ds/latest/iframe.html?id=components-button-variations--subtle-small-icon&args=&viewMode=story
Button props
Name | Control | Description |
---|---|---|
|
| The variant to use. |
|
| The size of the component. |
|
| If |
|
| The content of the component. |
|
| Element placed before the children. |
|
| Element placed after the children. |
|
|
|
|
|
|
|
|
|
Editorial
Button labels should use uppercase.
Button labels should be as short as possible, while clearly explaining the action the button triggers.
For maximum legibility, a text label should remain on a single line.
Names like “Read more“, “Learn more“, etc. should be avoided.
Behaviour
n/a
Accessibility
n/a
Related components
Link
A very brief description