---
title: "tinymce.WindowManager"
description: "This class handles the creation of native windows and dialogs. This class can be extended to provide for example inline dialogs."
canonical_url: "https://www.tiny.cloud/docs/tinymce/latest/apis/tinymce.windowmanager/"
md_url: "https://www.tiny.cloud/docs/tinymce/7/apis/tinymce.windowmanager/index.md"
version: "7"
last_updated: "2024-04-15T01:39:31Z"
tokens: 959
---
Important This page documents TinyMCE 7. For new projects, Tiny recommends using the latest, most up-to-date version. [See TinyMCE 8 documentation](../../../latest/apis/tinymce.windowmanager/).
# tinymce.WindowManager

This class handles the creation of native windows and dialogs. This class can be extended to provide for example inline dialogs.

## Examples

```javascript
// Opens a new dialog with the file.htm file and the size 320x240
tinymce.activeEditor.windowManager.openUrl({
  title: 'Custom Dialog',
  url: 'file.htm',
  width: 320,
  height: 240
});

// Displays an alert box using the active editor’s window manager instance
tinymce.activeEditor.windowManager.alert('Hello world!');

// Displays a confirm box. An alert message will display depending on what is chosen in the confirm box.
tinymce.activeEditor.windowManager.confirm('Do you want to do something?', (state) => {
  const message = state ? 'Ok' : 'Cancel';
  tinymce.activeEditor.windowManager.alert(message);
});
```

## Summary

### Methods

| Name | Summary | Defined by |
| --- | --- | --- |
| [alert()](#alert) | Creates an alert dialog. Do not use the blocking behavior of this native version. Use the callback method instead; then it can be extended. | `WindowManager` |
| [close()](#close) | Closes the top most window. | `WindowManager` |
| [confirm()](#confirm) | Creates an alert dialog. Do not use the blocking behavior of this native version. Use the callback method instead; then it can be extended. | `WindowManager` |
| [open()](#open) | Opens a new window. | `WindowManager` |
| [openUrl()](#openUrl) | Opens a new window for the specified url. | `WindowManager` |

## Methods

### alert()

```javascript
alert(message: String, callback: Function, scope: Object)
```
Creates an alert dialog. Do not use the blocking behavior of this
native version. Use the callback method instead; then it can be extended.

#### Examples

```javascript
// Displays an alert box using the active editors window manager instance
tinymce.activeEditor.windowManager.alert('Hello world!');
```

#### Parameters

- `message (String)` - Text to display in the new alert dialog.
- `callback (Function)` - (Optional) Callback function to be executed after the user has selected ok.
- `scope (Object)` - (Optional) Scope to execute the callback in.

### close()

```javascript
close()
```
Closes the top most window.

### confirm()

```javascript
confirm(message: String, callback: Function, scope: Object)
```
Creates an alert dialog. Do not use the blocking behavior of this
native version. Use the callback method instead; then it can be extended.

#### Examples

```javascript
// Displays a confirm box and an alert message will be displayed depending on what you choose in the confirm
tinymce.activeEditor.windowManager.confirm('Do you want to do something?', (state) => {
  const message = state ? 'Ok' : 'Cancel';
  tinymce.activeEditor.windowManager.alert(message);
});
```

#### Parameters

- `message (String)` - Text to display in the new confirm dialog.
- `callback (Function)` - (Optional) Callback function to be executed after the user has selected ok or cancel.
- `scope (Object)` - (Optional) Scope to execute the callback in.

### open()

```javascript
open(config: Object, params: Object): WindowManager.DialogInstanceApi
```
Opens a new window.

#### Parameters

- `config (Object)` - For information on the available options, see: [Dialog - Configuration options](/docs/tinymce/7/dialog-configuration/#options).
- `params (Object)` - (Optional) For information on the available options, see: [Dialog - Configuration parameters](/docs/tinymce/7/dialog-configuration/#configuration-parameters).

#### Return value

- `WindowManager.DialogInstanceApi` - A new dialog instance.

### openUrl()

```javascript
openUrl(config: Object): WindowManager.UrlDialogInstanceApi
```
Opens a new window for the specified url.

#### Parameters

- `config (Object)` - For information on the available options, see: [URL dialog - Configuration](/docs/tinymce/7/urldialog/#configuration).

#### Return value

- `WindowManager.UrlDialogInstanceApi` - A new URL dialog instance.