@ant-design/icons

What is @ant-design/icons?

The @ant-design/icons package provides a comprehensive collection of SVG icons for use in web development projects, specifically designed to be used with the Ant Design UI framework. It allows developers to easily incorporate icons into their applications for enhanced UI design and user experience.

What are @ant-design/icons's main functionalities?

Importing and using an icon

This feature allows developers to import specific icons from the package and use them in their React components. In this example, the 'UserOutlined' icon is imported and used inside an Avatar component.

import { UserOutlined } from '@ant-design/icons';

<Avatar icon={<UserOutlined />} />;

Customizing icon properties

Developers can customize icons by passing style properties. This example demonstrates changing the color and font size of the 'HeartOutlined' icon.

import { HeartOutlined } from '@ant-design/icons';

<HeartOutlined style={{ color: 'hotpink', fontSize: '16px' }} />;

Using icons with Ant Design components

Icons from the package can be seamlessly integrated with other Ant Design components. Here, the 'DownloadOutlined' icon is used within a Button component to create a download button.

import { Button } from 'antd';
import { DownloadOutlined } from '@ant-design/icons';

<Button icon={<DownloadOutlined />} type="primary">Download</Button>;

Other packages similar to @ant-design/icons

react-icons

React-icons provides a large set of icons from various icon libraries (FontAwesome, Ionicons, MaterialDesign, etc.) for React applications. Unlike @ant-design/icons, which is tailored for Ant Design, react-icons offers a broader selection from multiple sources, making it versatile for different design systems.

font-awesome

Font Awesome is a popular icon library that can be used in web projects. It provides icons as fonts and CSS. While it's not a React-specific package like @ant-design/icons, it's widely used across web development for adding icons due to its extensive collection and ease of use.

README

Ant Design Icons

⭐ The abstract trees of the Ant Design SVG icons.

⚠️ Status: Beta

⚠️ The APIs and icons may change in the future, please do NOT use in any production environment.

Install

yarn add @ant-design/icons # or npm install @ant-design/icons --save

Use Library Adapter

• React: See @ant-design/icons-react to learn about detail usage.

Usage

import { AntDesign } from '@ant-design/icons/es';

console.log(AntDesign);
// Output:
// { name: 'ant-design',
//   tag: 'svg',
//   attrs:
//    { xmlns: 'http://www.w3.org/2000/svg',
//      viewBox: '0 0 1024 1024' },
//   children:
//    [ { tag: 'path', attrs: [Object], children: [] },
//      { tag: 'path', attrs: [Object], children: [] } ] }

Interface

This library export all SVG files as IconDefinition.

interface AbstractNode {
  tag: string;
  attrs: {
    [key: string]: string;
  };
  children: AbstractNode[];
}

interface IconDefinition extends AbstractNode {
  name: string; // kebab-case-style
}

Build

npm run generate # Generate files to ./src
npm run build # Build library
npm run test # Runing Test