## 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('
Some HTML content
'); ``` 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