jQuery Common - Utils - ui - dialog (2024)

An object that serves as a namespace for methods displaying a message in an application/site.

alert(messageHtml, title)

Displays an alert dialog with a message and OK button.

import { alert } from "devextreme/ui/dialog"

Parameters:

messageHtml:

String

The dialog's message.
Can contain HTML markup that will be evaluated. Make sure that the markup does not contain malicious code.
Refer to the following help topic for more information: Potentially Vulnerable API - messageHtml.

title:

String

The dialog's title.

Return Value:

Promise<void> (jQuery or native)

A Promise that is resolved after a user clicks the button.It is a native Promise or a jQuery.Promise when you use jQuery.

confirm(messageHtml, title)

Creates a confirmation dialog with a message and Yes and No buttons.

import { confirm } from "devextreme/ui/dialog"

Parameters:

messageHtml:

String

The dialog's message.
Can contain HTML markup that will be evaluated. Make sure that the markup does not contain malicious code.
Refer to the following help topic for more information: Potentially Vulnerable API - messageHtml.

title:

String

The dialog's title.

Return Value:

Promise<Boolean> (jQuery or native)

A Promise that is resolved with a Boolean value indicating whether a user has clicked Yes or No.It is a native Promise or a jQuery.Promise when you use jQuery.

jQuery

JavaScript

$(function() { var result = DevExpress.ui.dialog.confirm("<i>Are you sure?</i>", "Confirm changes"); result.done(function(dialogResult) { alert(dialogResult ? "Confirmed" : "Canceled"); });})
Angular

app.component.ts

import { Component, AfterViewInit } from '@angular/core';import { confirm } from 'devextreme/ui/dialog';@Component({ selector: 'app-root', templateUrl: './app.component.html', styleUrls: ['./app.component.css']})export class AppComponent implements AfterViewInit{ ngAfterViewInit() { let result = confirm("<i>Are you sure?</i>", "Confirm changes"); result.then((dialogResult) => { alert(dialogResult ? "Confirmed" : "Canceled"); }); }}
Vue

App.vue

<template></template><script>import { confirm } from 'devextreme/ui/dialog';export default { mounted: function() { this.$nextTick(function() { let result = confirm("<i>Are you sure?</i>", "Confirm changes"); result.then((dialogResult) => { alert(dialogResult ? "Confirmed" : "Canceled"); }); }) }}</script>
React

App.js

import React from 'react';import { confirm } from 'devextreme/ui/dialog';class App extends React.Component { componentDidMount() { let result = confirm("<i>Are you sure?</i>", "Confirm changes"); result.then((dialogResult) => { alert(dialogResult ? "Confirmed" : "Canceled"); }); }}export default App;

custom(options)

Creates a dialog with custom buttons.

import { custom } from "devextreme/ui/dialog"

Parameters:

options:

Object

The dialog's properties.

Object structure:

Name Type Description
buttons

Array<Button Configuration>

Buttons to be displayed in the dialog.

dragEnabled

Boolean

Specifies whether the dialog window can be dragged. Defaults to the showTitle value.
Ensure the showTitle field is not explicitly set to false because a user can drag the dialog only by its title.

message

String

Use 'messageHtml' instead.

The dialog's message. Deprecated in favor of the messageHtml field.

messageHtml

String

The dialog's message.
Can contain HTML markup that will be evaluated. Make sure that the markup does not contain malicious code.
Refer to the following help topic for more information: Potentially Vulnerable API - messageHtml.

showTitle

Boolean

Specifies whether to show the title. Defaults to true.

title

String

The dialog's title.

Return Value:

Object

An object that represents the dialog.

The custom(options) method only creates a dialog. To display it, call the dialog instance's show() method. This method returns a Promise. To identify the clicked button, implement a Promise fulfillment handler. The dialog result is passed to the handler and contains anything you return from the clicked button's onClick function.

In the following code, the clicked button is identified by its text. The messageHtml field contains text with HTML tags.

jQuery

JavaScript

$(function() { var myDialog = DevExpress.ui.dialog.custom({ title: "Custom dialog", messageHtml: "<b>Dialog with custom buttons</b>", buttons: [{ text: "button 1", onClick: function(e) { return { buttonText: e.component.option("text") } } }, // ... ] }); myDialog.show().done(function(dialogResult) { console.log(dialogResult.buttonText); });})
Angular

app.component.ts

import { Component, AfterViewInit } from '@angular/core';import { custom } from 'devextreme/ui/dialog';@Component({ selector: 'app-root', templateUrl: './app.component.html', styleUrls: ['./app.component.css']})export class AppComponent implements AfterViewInit { ngAfterViewInit() { let myDialog = custom({ title: "Custom dialog", messageHtml: "<b>Dialog with custom buttons</b>", buttons: [{ text: "button 1", onClick: (e) => { return { buttonText: e.component.option("text") } } }, // ... ] }); myDialog.show().then((dialogResult) => { console.log(dialogResult.buttonText); }); }}
Vue

App.vue

<template></template><script>import { custom } from 'devextreme/ui/dialog';export default { mounted: function() { this.$nextTick(function() { let myDialog = custom({ title: "Custom dialog", messageHtml: "<b>Dialog with custom buttons</b>", buttons: [{ text: "button 1", onClick: (e) => { return { buttonText: e.component.option("text") } } }, // ... ] }); myDialog.show().then((dialogResult) => { console.log(dialogResult.buttonText); }); }) }}</script>
React

App.js

import React from 'react';import { custom } from 'devextreme/ui/dialog';class App extends React.Component { componentDidMount() { let myDialog = custom({ title: "Custom dialog", messageHtml: "<b>Dialog with custom buttons</b>", buttons: [{ text: "button 1", onClick: (e) => { return { buttonText: e.component.option("text") } } }, // ... ] }); myDialog.show().then((dialogResult) => { console.log(dialogResult.buttonText); }); }}export default App;

Call the hide() method to close the dialog before any button is clicked. In the following code, the dialog is closed after 5 seconds if a user does not click any button:

setTimeout(function() { myDialog.hide(); }, 5000);

Was this topic helpful?

Feel free toshare topic-related thoughts here.
Ifyou have technical questions, please create asupport ticket inthe DevExpress Support Center.

Thank you for the feedback!

jQuery Common - Utils - ui - dialog (2024)
Top Articles
Latest Posts
Article information

Author: Duncan Muller

Last Updated:

Views: 5627

Rating: 4.9 / 5 (79 voted)

Reviews: 86% of readers found this page helpful

Author information

Name: Duncan Muller

Birthday: 1997-01-13

Address: Apt. 505 914 Phillip Crossroad, O'Konborough, NV 62411

Phone: +8555305800947

Job: Construction Agent

Hobby: Shopping, Table tennis, Snowboarding, Rafting, Motor sports, Homebrewing, Taxidermy

Introduction: My name is Duncan Muller, I am a enchanting, good, gentle, modern, tasty, nice, elegant person who loves writing and wants to share my knowledge and understanding with you.