文档
Storybook Docs

IconGallery

IconGallery 块可让您轻松记录与项目相关的 React 图标组件,这些组件会以整齐的网格显示。

Screenshot of IconGallery and IconItem blocks

记录图标

要记录一组图标,请使用 IconGallery 块将它们显示在网格中。每个图标都包装在 IconItem 块中,您可以为其指定属性,例如名称和图标本身。

Iconography.mdx
import { Meta, IconGallery, IconItem } from '@storybook/addon-docs/blocks';
 
import { Icon as IconExample } from './Icon';
 
<Meta title="Iconography" />
 
# Iconography
 
<IconGallery>
  <IconItem name="mobile">
    <IconExample name="mobile" />
  </IconItem>
  <IconItem name="user">
    <IconExample name="user" />
  </IconItem>
  <IconItem name="browser">
    <IconExample name="browser" />
  </IconItem>
  <IconItem name="component">
    <IconExample name="component" />
  </IconItem>
  <IconItem name="calendar">
    <IconExample name="calendar" />
  </IconItem>
   <IconItem name="paintbrush">
    <IconExample name="paintbrush" />
  </IconItem>
   <IconItem name="add">
    <IconExample name="add" />
  </IconItem>
  <IconItem name="subtract">
    <IconExample name="subtract" />
  </IconItem>
   <IconItem name="document">
    <IconExample name="document" />
  </IconItem>
  <IconItem name="graphline">
    <IconExample name="graphline" />
  </IconItem>
</IconGallery>

自动记录图标

如果您正在处理一个包含大量图标且您希望记录它们的大型项目,您可以扩展 IconGallery 块,将 IconItem 包装在一个循环中,并遍历您想要记录的图标,包括它们的属性。例如:

Iconography.mdx
import { Meta, IconGallery, IconItem } from '@storybook/addon-docs/blocks';
 
import { Icon as IconExample } from './Icon';
import * as icons from './icons';
 
# Iconography
 
<IconGallery>
  {Object.keys(icons).map((icon) => (
    <IconItem name={icon}>
      <IconExample icon={icon} />
    </IconItem>
  ))}
</IconGallery>

IconGallery

import { IconGallery } from '@storybook/addon-docs/blocks';

IconGallery 的配置包含以下 props:

children

类型: React.ReactNode

IconGallery 只接受 IconItem 子组件。

IconItem

import { IconItem } from '@storybook/addon-docs/blocks';

IconItem 的配置包含以下 props:

name

(必需)

类型:string

设置图标的名称。

children

类型: React.ReactNode

提供要显示的图标。