@lightspeed/cirrus-button

The most essential element of a user interface.

---

Sizes

Our buttons come in four different sizes: Small, Medium, Large & Extra Large. All buttons have a fixed height and padding unless stated differently inside the type
| Size | Usage | | ---- | ----- | | small | These little buttons are used in compact little spaces, e.g. inside the header of a card. | | large | The large button is mainly used inside an open but content-rich page with multiple actions. This large button also provides a large touchable area for use on touch screens. | | xlarge | When a single page has nothing going on but to promote a single thing with just one button, you should use the extra large button. This button is also great for fast pacing flows with a focus on touch screens. |

Styles

These are all the styles that are included in all button types (unless stated differently in the types section).
| Style | Usage | | ----- | ----- | | default | The neutral button is used for all generic actions. | | primary | There should only be one main action on the page. This action should always be a primary styled button. | | secondary | For subsequent actions that encourage our users to fill data like selecting a product. | | danger | For all actions that can be destructive, we use the danger styled button. |

Types

These are all the styles that are included in all button types (unless stated differently in the types section).
| Type | Usage | | ---- | ----- | | Outline| Our standard button is for all non-default styles the outline button can transform into a fill button to start encouraging interaction. | | Fill| When taking action is promoted/encouraged we use the fill button. The main CTA should always be a fill. Not available in default style. | | Icon + Text | Bringing visual context to what a button will do, can help the user understand and it manages expectations. When space is limited, but actions are required you might want to use an icon only button. | | Icon | A small, often square-shaped button with only an <Icon> for CTA. These should be avoided at all costs, unless when dealing with extremely standard usecases. Consider an Icon + Text button instead.

---

Installation

First, make sure you have been through the Getting Started steps of adding Cirrus in your application.
If using Yarn:

yarn add @lightspeed/cirrus-button

Or using npm:

npm i -S @lightspeed/cirrus-button

---

Usage

Import required styles in your .scss:

@import '@lightspeed/cirrus-button/Button.scss';

React Component

Props

| Prop | Type | Description | | ---- | ---- | ----------- | | children | React.ReactNode | The content to display inside the button | | primary | boolean | Displays as success button | | secondary | boolean | Displays as secondary button | | danger | boolean | Displays as danger button | | fill | boolean | Displays as fill button | | size | enum'small', 'large', 'xlarge' | Sets the size of the button | | block | boolean | Displays the button in full width | | noSpacing | boolean | Remove default spacing between button children | | disabled | boolean | Disables the button | | loading | boolean | Displays the loading icon and disables the button | | href | string | Creates a <a> link instead of a <button> | | active | boolean | Displays the button in an active state | | onClick | function | Callback when button is clicked | | onFocus | function | Callback when button is focused | | onBlur | function | Callback when button is blurred |

Example

import React from 'react';
import Button from '@lightspeed/cirrus-button';

const MyComponent = () => (
  <div>
    <Button>My Button</Button>
  </div>
);

export default MyComponent;

CSS Component

Classes

Besides the base class .cr-button you can use one of these classes:
| Type | Class | | ---- | ----- | | primary | .cr-button--primary | | secondary | .cr-button--secondary | | danger | .cr-button--danger | | fill | .cr-button--fill | | block | .cr-button--block | | noSpacing | .cr-button--no-spacing | | small | .cr-button--small | | large | .cr-button--large | | xlarge | .cr-button--xlarge | | disabled | .cr-button--disabled (only for links, use the disabled attribute on <button>) | | loading | .cr-button--loading |
The button contains a <span /> to vertically align the content:
| Type | Class | | ---- | ----- | | content | .cr-button__content | | loading | .cr-button__content--loading |

Example

<button type="button" class="cr-button">
  <span class="cr-button__content">My Button</span>
</button>

<button type="button" class="cr-button cr-button--loading" disabled>
  <span class="cr-button__content cr-button__content--loading">
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" class="cr-icon cr-icon-spinner cr-spinner" style="width: 1.125rem; height: 1.125rem;">
      <path class="cr-icon__base cr-icon__base-2" d="M8 16A8 8 0 1 1 8 0a8 8 0 0 1 0 16zm0-3A5 5 0 1 0 8 3a5 5 0 0 0 0 10z" opacity=".3"></path>
      <path class="cr-icon__base cr-icon__base-1" d="M8 13a1.5 1.5 0 0 1 0 3A8 8 0 0 1 .323 5.742a1.5 1.5 0 1 1 2.879.846A5 5 0 0 0 8 13z"></path>
    </svg>
  </span>
  <span class="cr-button__content">My Button</span>
</button>