加入在线会议:美国东部时间周四上午 11 点,Storybook 9 发布及 AMA
文档
Storybook 文档

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

提供要显示的图标。