@wordpress/block-editor/src/components/block-card/README.md

Generic block editor.

# Block Card

The `BlockCard` component allows to display a "card" which contains the title of a block, its icon and its description.

In the editor, this component is displayed in two different places: in the block inspector by selecting a block, and as a modal by hovering over a block in the block insertion panel.

![Heading block card in the block inspector](https://make.wordpress.org/core/files/2020/09/screenshot-wordpress.org-2020.09.08-14_19_21.png)

## Development guidelines

### Usage

Renders a block card with default style.

```jsx
import { BlockCard } from '@wordpress/block-editor';
import { paragraph } from '@wordpress/icons';

const MyBlockCard = () => (
	<BlockCard
		icon={ paragraph }
		title="Paragraph"
		description="Start with the basic building block of all narrative."
		name="Custom Block"
	/>
);
```

### Props

#### icon

-   **Type:** `String` | `Object`

The icon of the block. This can be any of [WordPress' Dashicons](https://developer.wordpress.org/resource/dashicons/), or a custom `svg` element.

#### title

-   **Type:** `String`

The title of the block.

#### description

-   **Type:** `String`

The description of the block.

#### name

-   **Type:** `String`

The custom name of the block.

## Related components

Block Editor components are components that can be used to compose the UI of your block editor. Thus, they can only be used under a [`BlockEditorProvider`](https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/provider/README.md) in the components tree.