1
0
mirror of https://github.com/kremalicious/metamask-extension.git synced 2024-12-23 09:52:26 +01:00
metamask-extension/ui/components/component-library/button-base
Garrett Bear 1265731344
Feat/16637/button housekeeping (#16872)
* button housekeeping

* add iconsearch

* fix description

* readme update

* update disabled classnames

* buttonlink disabled class

* add disabled proptypes

* add constant exports

* update disabled style classes

* update snapshot for box pill classname

* add buttonTextProps

* update primarybutton background color to use box props

* update button secondary and link to use box props

* update tests
2023-01-13 13:58:09 -08:00
..
__snapshots__ Feat/16637/button housekeeping (#16872) 2023-01-13 13:58:09 -08:00
button-base.constants.js button base housekeeping (#16336) 2022-11-03 11:41:16 -07:00
button-base.js Feat/16637/button housekeeping (#16872) 2023-01-13 13:58:09 -08:00
button-base.scss Feat/16637/button housekeeping (#16872) 2023-01-13 13:58:09 -08:00
button-base.stories.js Feat/16637/button housekeeping (#16872) 2023-01-13 13:58:09 -08:00
button-base.test.js Feat/16637/button housekeeping (#16872) 2023-01-13 13:58:09 -08:00
index.js button base housekeeping (#16336) 2022-11-03 11:41:16 -07:00
README.mdx Feat/16637/button housekeeping (#16872) 2023-01-13 13:58:09 -08:00

import { Story, Canvas, ArgsTable } from '@storybook/addon-docs';
import { ButtonBase } from './button-base';

### This is a base component. It should not be used in your feature code directly but as a "base" for other UI components

# ButtonBase

The `ButtonBase` is the base component for buttons.

<Canvas>
  <Story id="ui-components-component-library-button-base-button-base-stories-js--default-story" />
</Canvas>

## Props

The `ButtonBase` accepts all props below as well as all [Box](/docs/ui-components-ui-box-box-stories-js--default-story#props) component props

<ArgsTable of={ButtonBase} />

### Size

Use the `size` prop and the `SIZES` object from `./ui/helpers/constants/design-system.js`
to change the size of `ButtonBase`. Defaults to `SIZES.MD`

Optional: `BUTTON_BASE_SIZES` from `./button-base` object can be used instead of `SIZES`.

Possible sizes include:

- `SIZES.AUTO` inherits the font-size of the parent element.
- `SIZES.SM` 32px
- `SIZES.MD` 40px
- `SIZES.LG` 48px

<Canvas>
  <Story id="ui-components-component-library-button-base-button-base-stories-js--size" />
</Canvas>

```jsx
import { SIZES } from '../../../helpers/constants/design-system';
import { ButtonBase } from '../../ui/components/component-library';

<ButtonBase size={SIZES.AUTO} />
<ButtonBase size={SIZES.SM} />
<ButtonBase size={SIZES.MD} />
<ButtonBase size={SIZES.LG} />
```

### Block

Use boolean `block` prop to quickly enable a full width block button

<Canvas>
  <Story id="ui-components-component-library-button-base-button-base-stories-js--block" />
</Canvas>

```jsx
import { DISPLAY } from '../../../helpers/constants/design-system';
import { ButtonBase } from '../../ui/components/component-library';

<ButtonBase>Default Button</ButtonBase>
<ButtonBase block>Block Button</ButtonBase>
```

### As

Use the `as` box prop to change the element of `ButtonBase`. Defaults to `button`.

When an `href` prop is passed it will change the element to an anchor(`a`) tag.

Button `as` options:

- `button`
- `a`

<Canvas>
  <Story id="ui-components-component-library-button-base-button-base-stories-js--as" />
</Canvas>

```jsx
import { ButtonBase } from '../../ui/components/component-library';


<ButtonBase as="button">Button Element</ButtonBase>
<ButtonBase as="a" href="#">
  Anchor Element
</ButtonBase>
```

### Href

When an `href` prop is passed it will change the element to an anchor(`a`) tag.

<Canvas>
  <Story id="ui-components-component-library-button-base-button-base-stories-js--href" />
</Canvas>

```jsx
import { ButtonBase } from '../../ui/components/component-library';

<ButtonBase href="/metamask">Anchor Element</ButtonBase>;
```

### Disabled

Use the boolean `disabled` prop to disable button

<Canvas>
  <Story id="ui-components-component-library-button-base-button-base-stories-js--disabled" />
</Canvas>

```jsx
import { ButtonBase } from '../../ui/components/component-library';

<ButtonBase disabled>Disabled Button</ButtonBase>;
```

### Loading

Use the boolean `loading` prop to set loading spinner

<Canvas>
  <Story id="ui-components-component-library-button-base-button-base-stories-js--loading" />
</Canvas>

```jsx
import { ButtonBase } from '../../ui/components/component-library';

<ButtonBase loading>Loading Button</ButtonBase>;
```

### Icon Name

Use the `iconName` prop and the `ICON_NAMES` object from `./ui/components/component-library` to select icon.

<Canvas>
  <Story id="ui-components-component-library-button-base-button-base-stories-js--iconName" />
</Canvas>

```jsx
import { ButtonBase } from '../../ui/components/component-library';
import { ICON_NAMES } from '../icon';

<ButtonBase iconName={ICON_NAMES.ADD_SQUARE_FILLED}>Button</ButtonBase>;
```