
# addFile

Files are atomic (non-text) blocks that are used to embed downloadable links on the webpage.

## Usage

The `addFile` utility will help you to add file to the editor.

```ts
addFile(
  state: State,
  stateHandler: StateHandler,
  attributes?: FileAttributes
) => 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 `addFile` usage:

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

const File = (props) => {
  return (
    <a href={props.href} download>
      Download File
    </a>
  );
};

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

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

  return (
    <>
      <Editor
        editorState={editorState}
        onChange={setEditorState}
        editorRef={editorRef}
      />
      <button
        onClick={() => {
          addFile(editorState, setEditorState, {
            href: '', // File link here
          });
        }}
      >
        Add File
      </button>
    </>
  );
};

export default Demo;
```


File 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

addFile

Usage #

Example #