Icons

React Suite provides some guidance and suggestions for using icons in React Suite applications.

React Suite Icons

React Suite provides a set of icon components, you need to install the @rsuite/icons icon component.

React Suite Icons

npm install --save @rsuite/icons

Usage

import GearIcon from '@rsuite/icons/Gear';
import AddOutlineIcon from '@rsuite/icons/AddOutline';

// or
import { Gear, AddOutline } from '@rsuite/icons';

Size

Color

Animating

Flip and rotate

Icon extension

Custom SVG icon

Font awesome icons

Font awesome provides 3 sets of open source icons, which can be installed as required:

npm install --save @fortawesome/free-brands-svg-icons
npm install --save @fortawesome/free-regular-svg-icons
npm install --save @fortawesome/free-solid-svg-icons

Usage

React Icons

react-icons contains popular icons. The following example will demonstrate how to use it in combination with Icon.

npm install react-icons --save

Iconfont Icons

If you are a user of iconfont.cn, you can use the createIconFont method to import icon resources and use them in components.

Props

<Icon>

Both <Icon> and the imported single icon have the following props.

Property Type (Default) Description
as ElementType<SVGElement> Custom svg icon component
fill string (currentColor) Icon fill color
flip 'horizontal' | 'vertical' Flip icon
pulse boolean Use pulse to have it rotate with eight steps
rotate number Rotate icon
spin boolean Use the spin to get any icon to rotate
style CSSProperties The style properties of icon, like fontSize and color

createIconFont

Property Type (Default) Description
commonProps HTMLAttributes<SVGElement> Define extra properties to the component
scriptUrl string | string[] Use the js url generated online by iconfont.cn, or you can use the local url

<IconFont>

<IconFont> is a component created by createIconFont.

const IconFont = createIconFont(...);
Property Type (Default) Description
fill string (currentColor) Icon fill color
flip 'horizontal' | 'vertical' Flip icon
icon string Use the name from the iconfont icon set
pulse boolean Use pulse to have it rotate with eight steps
rotate number Rotate icon
spin boolean Use the spin to get any icon to rotate
style CSSProperties The style properties of icon, like fontSize and color