19.1.0 • Published 1 day ago

@commercetools-uikit/icons v19.1.0

Weekly downloads
4,079
License
MIT
Repository
github
Last release
1 day ago

Icons

Description

All SVG icons are rendered as React components.

Usage

import { ExportIcon } from '@commercetools-uikit/icons';

<ExportIcon />;

Properties

PropsTypeRequiredValuesDefaultDescription
sizestring'small', 'medium', 'big', 'scale''big'Specifies the icon size (if scale is selected, the dimensions will scale according with the parents)
colorstring'solid', 'neutral60', 'info', 'primary', 'primary40', 'warning', 'error''solid'Specifies the icon color

Where to use

Main use cases are:

  • Buttons

    <SecondaryButton
      onClick={() => {}}
      iconLeft={<ExportIcon />}
      label={this.props.intl.formatMessage(messages.exportList)}
    />
  • Icon Buttons

    <IconButton
      onClick={() => {}}
      icon={<ExportIcon />}
      label={this.props.intl.formatMessage(messages.exportList)}
    />

Inline SVG for rendering custom icons

If you need to render an SVG icon that is not part of the default set of icons, it's possible to render it using a special component <InlineSvg>.

The component is exported as a separate entry point:

import InlineSvg from '@commercetools-uikit/icons/inline-svg';

Usage

import InlineSvg from '@commercetools-uikit/icons/inline-svg';

const svg = `<svg><path ... /></svg>`;

const App = () => <InlineSvg data={svg} color="primary" size="medium" />;

The component accepts the same props as the <*Icon> components color and size. Additionally it requires the data prop, which is the actual SVG content.

XSS protection

The data passed to the component is run through a DOM sanitizer to prevent unwanted XSS injections.

Where to use

This component can be used whenever the icon has to be rendered dynamically on runtime. For example in the Merchant Center this can be the case for the navigation menu icons, etc.

Leading Icon

The leading icon is a an eye-catching visual element that should be used when an additional visual prominence is needed for a content section in the UI. The different colours in combination with the icons can be utilised to create certain categorisation of the elements in the UI.

The component is exported as a separate entry point:

import LeadingIcon from '@commercetools-uikit/icons/leading-icon';

Usage

import LeadingIcon from '@commercetools-uikit/icons/leading-icon';
import { ExportIcon } from '@commercetools-uikit/icons';

const app = () => <LeadingIcon icon={<ExportIcon />} />;

Properties

PropsTypeRequiredValuesDefaultDescription
sizestring'10', '20', '30', '40''20'Specifies the icon size
colorstring'accent', 'brown', 'neutral', 'purple', 'turquoise', 'white''neutral'Specifies the icon's background color and fill color
isInvertedbooleantrue, falsefalseSpecifies whether the icon has a light background and dark fill (false), or dark background and light fill (true)
iconReactElementUI Kit <Icon/> componentIcon that is displayed within the component, you must supply a child icon with with this prop or the svg prop
svgstringA custom SVG to displayIcon that is displayed using the InlineSvg component, you must supply a child icon with with this prop or the icon prop

Where to use

This component can be used wherever it is necessary to display a themed icon.

@commercetools-frontend/application-shell@commercetools-docs/gatsby-theme-docs@commercetools-uikit/password-field@commercetools-uikit/async-select-input@commercetools-uikit/async-creatable-select-input@commercetools-uikit/collapsible-panel@commercetools-uikit/data-table@commercetools-uikit/creatable-select-input@commercetools-uikit/data-table-manager@commercetools-uikit/localized-money-input@commercetools-uikit/localized-rich-text-input@commercetools-uikit/localized-multiline-text-input@commercetools-uikit/select-input@commercetools-uikit/localized-text-input@commercetools-uikit/money-input@everything-registry/sub-chunk-190@commercetools-uikit/date-time-input@commercetools-community-kit/pickers@commercetools-docs/gatsby-theme-learning@commercetools-docs/gatsby-theme-sso-ui-kit@commercetools-docs/ui-kit@commercetools-frontend-extensions/change-history@commercetools-uikit/date-range-input@commercetools-uikit/date-input@commercetools-uikit/input-utils@commercetools-uikit/link@commercetools-uikit/radio-input@commercetools-uikit/rich-text-body@commercetools-uikit/rich-text-input@commercetools-uikit/select-utils@commercetools-uikit/selectable-search-input@commercetools-uikit/rich-text-utils@commercetools-uikit/search-text-input@commercetools-uikit/table@commercetools-frontend/ui-kit@commercetools-frontend/react-notifications@commercetools-uikit/field-label@commercetools-uikit/multiline-text-input@commercetools-uikit/notifications@commercetools-uikit/primary-action-dropdown@commercetools-uikit/pagination@commercetools-frontend/application-components@commercetools-uikit/calendar@commercetools-uikit/base-table@commercetools-uikit/calendar-utils@commercetools-uikit/checkbox-input@commercetools-uikit/time-input@commercetools-uikit/tag@infinitebrahmanuniverse/nolb-_comm
19.1.0

10 days ago

19.0.0

1 month ago

18.5.0

1 month ago

18.4.0

2 months ago

18.3.0

2 months ago

18.2.0

2 months ago

18.1.0

2 months ago

18.0.0

2 months ago

17.1.0

3 months ago

17.0.1

3 months ago

17.0.0

3 months ago

16.12.1

5 months ago

16.12.0

5 months ago

16.5.0

10 months ago

16.6.1

8 months ago

16.6.0

9 months ago

16.4.1

10 months ago

16.9.0

6 months ago

16.7.3

8 months ago

16.7.2

8 months ago

16.7.1

8 months ago

16.7.0

8 months ago

16.7.5

7 months ago

16.7.4

7 months ago

16.8.0

6 months ago

16.11.0

5 months ago

16.10.0

5 months ago

16.4.0

10 months ago

16.3.0

10 months ago

16.2.1

11 months ago

16.2.0

11 months ago

16.1.1

11 months ago

16.1.0

12 months ago

15.15.0

1 year ago

15.15.1

1 year ago

16.0.0

1 year ago

15.13.2

1 year ago

15.14.3

1 year ago

15.14.1

1 year ago

15.14.2

1 year ago

15.14.0

1 year ago

15.13.1

1 year ago

15.13.0

1 year ago

15.12.0

1 year ago

15.9.0

1 year ago

15.10.0

1 year ago

15.11.2

1 year ago

15.11.0

1 year ago

15.11.1

1 year ago

15.7.0

1 year ago

15.8.0

1 year ago

15.5.0

1 year ago

15.5.1

1 year ago

15.6.0

1 year ago

15.4.0

1 year ago

15.3.0

2 years ago

15.2.4

2 years ago

15.2.1

2 years ago

15.2.2

2 years ago

15.2.3

2 years ago

15.1.1

2 years ago

15.1.2

2 years ago

15.1.0

2 years ago

15.2.0

2 years ago

15.0.0

2 years ago

14.0.0

2 years ago

14.0.1

2 years ago

13.0.2

2 years ago

13.0.0

2 years ago

12.2.9

2 years ago

12.2.5

2 years ago

12.2.6

2 years ago

12.2.7

2 years ago

12.2.4

3 years ago

12.2.3

3 years ago

12.2.2

3 years ago

12.2.1

3 years ago

12.2.0

3 years ago

12.1.0

3 years ago

12.0.12

3 years ago

12.0.8

3 years ago

12.0.7

3 years ago

12.0.0

3 years ago

11.2.1

3 years ago

11.2.0

3 years ago

11.0.2

3 years ago

11.0.1

3 years ago

10.47.4

3 years ago

10.47.3

3 years ago

10.47.0

3 years ago

10.46.3

3 years ago

10.44.4

3 years ago

10.44.1

3 years ago

10.44.0

3 years ago

10.43.3

3 years ago

10.43.2

3 years ago

10.42.3

3 years ago

10.42.2

3 years ago

10.42.0

3 years ago

10.42.1

3 years ago

10.41.0

3 years ago

10.40.1

3 years ago

10.40.0

3 years ago

10.39.8

3 years ago

10.39.7

3 years ago

10.39.6

3 years ago

10.39.4

3 years ago

10.39.2

3 years ago

10.39.3

3 years ago

10.39.1

3 years ago

10.38.0

4 years ago

10.33.0

4 years ago

10.30.1

4 years ago

10.24.0

4 years ago

10.22.0

4 years ago

10.20.0

4 years ago

10.19.0

4 years ago

10.18.7-canary.5

4 years ago

10.18.7-canary.6

4 years ago

10.18.7-canary.7

4 years ago

10.18.7-canary.4

4 years ago

10.18.7-canary.3

4 years ago

10.18.7-canary.2

4 years ago

10.18.7-canary.1

4 years ago

10.18.6-canary.1

4 years ago

10.18.7-canary.0

4 years ago

10.18.5-canary.4

4 years ago

10.18.6-canary.0

4 years ago

10.18.5-canary.3

4 years ago

10.18.5-canary.2

4 years ago

10.18.5-canary.1

4 years ago

10.18.5-canary.0

4 years ago

10.18.4

4 years ago

10.18.4-canary.9

4 years ago

10.18.4-canary.8

4 years ago

10.18.4-canary.7

4 years ago

10.18.4-canary.6

4 years ago

10.18.4-canary.3

4 years ago

10.18.4-canary.4

4 years ago

10.18.4-canary.5

4 years ago

10.18.4-canary.1

4 years ago

10.18.4-canary.2

4 years ago

10.18.4-canary.0

4 years ago

10.18.3-canary.2

4 years ago

10.18.3-canary.3

4 years ago

10.18.3-canary.1

4 years ago

10.18.3-canary.0

4 years ago

10.18.2-canary.3

4 years ago

10.18.2-canary.2

4 years ago

10.18.2-canary.1

4 years ago

10.17.1-canary.3

4 years ago

10.17.1-canary.2

4 years ago

10.18.1-canary.0

4 years ago

10.18.2-canary.0

4 years ago

10.17.1-canary.1

4 years ago

10.17.0

4 years ago

10.17.1-canary.0

4 years ago

10.16.1-canary.8

4 years ago

10.16.1-canary.7

4 years ago

10.16.1-canary.6

4 years ago

10.16.1-canary.5

4 years ago

10.16.1-canary.4

4 years ago

10.16.1-canary.3

4 years ago

10.16.1-canary.2

4 years ago

10.16.1-canary.1

4 years ago

10.16.1-canary.0

4 years ago

10.15.2-canary.4

4 years ago

10.15.2-canary.2

4 years ago

10.15.2-canary.3

4 years ago

10.15.1-canary.6

4 years ago

10.15.1

4 years ago

10.15.1-canary.4

4 years ago

10.14.1

4 years ago

10.14.1-canary.7

4 years ago

10.13.0

4 years ago

11.0.0-alpha.11

4 years ago

11.0.0-alpha.10

4 years ago

11.0.0-alpha.9

4 years ago

11.0.0-alpha.6

4 years ago

11.0.0-alpha.7

4 years ago

11.0.0-alpha.8

4 years ago

11.0.0-alpha.5

4 years ago

11.0.0-alpha.4

4 years ago

11.0.0-alpha.2

4 years ago

11.0.0-alpha.3

4 years ago

11.0.0-alpha.1

4 years ago

11.0.0-alpha.0

4 years ago