<!-- Generated by documentation.js. Update this documentation by updating the source code. -->

## Modal

You can customize the initial state of the module from the editor initialization, by passing the following [Configuration Object][1]

```js
const editor = grapesjs.init({
 modal: {
   // options
 }
})
```

Once the editor is instantiated you can use its API. Before using these methods you should get the module from the instance

```js
const modal = editor.Modal;
```

-   [open][2]
-   [close][3]
-   [isOpen][4]
-   [setTitle][5]
-   [getTitle][6]
-   [setContent][7]
-   [getContent][8]
-   [onceClose][9]
-   [onceOpen][10]

## open

Open the modal window

### Parameters

-   `opts` **[Object][11]** Options (optional, default `{}`)
    -   `opts.title` **([String][12] \| [HTMLElement][13])?** Title to set for the modal
    -   `opts.content` **([String][12] \| [HTMLElement][13])?** Content to set for the modal
    -   `opts.attributes` **[Object][11]?** Updates the modal wrapper with custom attributes

Returns **this** 

## close

Close the modal window

Returns **this** 

## onceClose

Execute callback when the modal will be closed.
The callback will be called one only time

### Parameters

-   `clb` **[Function][14]** 

Returns **this** 

## onceOpen

Execute callback when the modal will be opened.
The callback will be called one only time

### Parameters

-   `clb` **[Function][14]** 

Returns **this** 

## isOpen

Checks if the modal window is open

Returns **[Boolean][15]** 

## setTitle

Set the title to the modal window

### Parameters

-   `title` **[string][12]** Title

### Examples

```javascript
modal.setTitle('New title');
```

Returns **this** 

## getTitle

Returns the title of the modal window

Returns **[string][12]** 

## setContent

Set the content of the modal window

### Parameters

-   `content` **([string][12] \| [HTMLElement][13])** Content

### Examples

```javascript
modal.setContent('<div>Some HTML content</div>');
```

Returns **this** 

## getContent

Get the content of the modal window

Returns **[string][12]** 

[1]: https://github.com/artf/grapesjs/blob/master/src/modal_dialog/config/config.js

[2]: #open

[3]: #close

[4]: #isopen

[5]: #settitle

[6]: #gettitle

[7]: #setcontent

[8]: #getcontent

[9]: #onceclose

[10]: #onceopen

[11]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object

[12]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String

[13]: https://developer.mozilla.org/docs/Web/HTML/Element

[14]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function

[15]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
