Buttons are clickable elements that are used to perform an action.
Usage
Do’s
Use a button when the user can perform an action without navigating to a new page.
Use a primary button to indicate the main action of a group button set.
Use action verbs or phrases to tell the user what will happen next.
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.
Don’t use long labels
Anatomy
Item | Component type | Content type | Notes | |
---|---|---|---|---|
1 | Leading icon | Icon | SVG file | OPTIONAL |
2 | Button label | Typography | Text | MANDATORY |
3 | Trailing icon (not shown) | Icon | SVG file | OPTIONAL |
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 standard case.
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.
Swap phrases like “Read more“, “Learn more“, and “Click here“ for more specific action oriented phrases.
Behaviour
tbd
Accessibility
tbd