IconGallery
IconGallery
块使您能够轻松地文档化项目中关联的 React 图标组件,并以整洁的网格形式显示它们。
文档化图标
要文档化一组图标,请使用 IconGallery
块以网格形式显示它们。每个图标都包装在 IconItem
块中,使您能够指定其属性,例如名称和图标本身。
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
包装在循环中,并迭代需要文档化的图标,包括它们的属性。例如:
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
提供要显示的图标。