
# addImage

Images are atomic (non-text) blocks that are used to embed image on the webpage.

## Usage

The `addImage` utility will help you to add image to the editor.
Image attributes can be either `image` or `picture` ones.

```ts
addImage(
  state: State,
  stateHandler: StateHandler,
  attributes?: ImageAttributes
) => void
```

Whenever you use an atomic block in your content, You need to [decorate](/docs/decorators/overview)
your state to make it available to render your custom non-text content.

## Example

An example of `addImage` usage:

```ts
import { useState, useEffect } from 'react';
import { EditorState } from 'draft-js';
import { Editor, addImage, createDecorator, findEntitiesOf } from 'contenido';

const Image = (props) => {
  return <img alt={props.alt} src={props.src} />;
};

const Demo = () => {
  const decorators = createDecorator([
    {
      component: Image,
      strategy: findEntitiesOf('image'),
    },
  ]);

  const [editorState, setEditorState] = useState(
    EditorState.createEmpty(decorators)
  );

  return (
    <>
      <Editor
        editorState={editorState}
        onChange={setEditorState}
        editorRef={editorRef}
      />
      <button
        onClick={() => {
          addImage(editorState, setEditorState, {
            src: 'https://picsum.photos/200/200',
            alt: 'Random image',
            style: { width: 200, height: 200 },
          });
        }}
      >
        Add Image
      </button>
    </>
  );
};

export default Demo;
```


Image Block

overview

installation

getting-started

custom-styles

bold

italic

underline

line-through

overline

superscript

subscript

color

transform

inline-styles

custom-block-type

heading-1-to-6

paragraph

list

blockquote

text-alignment

block-types

link

decorators

custom-atomic-block

image-block

video-block

audio-block

file-block

atomic-count

image-count

video-count

audio-count

file-count

atomic-blocks

focus-on-editor

empty-raw-content-state

selected-blocks-map

clear-inline-styles

clear-block-types

soft-newline

clear-entities

clear

character-count

plain-text

word-array

word-count

find-entities

find-link-entities

entity-count

generate-key

helpers

shortcuts

shortcuts-map

addImage

Usage #

Example #