Configuration
This article describes how to configure message boxes, alert boxes, confirm boxes, and tooltips.
Message box
Related sample: Message. Show Message
You can configure a message box when you create it with dhx.message():
dhx.message({
text:"Message text",
icon:"dxi-clock",
css:"expire",
expire:1000
});
Related sample: Message. Message Configuration
See the full list of configuration properties that the message box constructor accepts.
Working with message box
From v8.0, dhx.message() returns an object with the close() method. Call this method to close the message box:
<section class="dhx_sample-controls">
<button id="show" class="dhx_sample-btn dhx_sample-btn--flat" onclick="show()">show</button>
<button id="close" class="dhx_sample-btn dhx_sample-btn--flat" onclick="close()">close</button>
</section>
<script>
let message;
function show() {
message = dhx.message({ text: "Here is dhtmlxMessage", icon: "dxi-close" });
}
document.querySelector("#close").addEventListener("click", () => {
message?.close()
});
</script>
Related sample: Message. Show Message
Alert box

Related sample: Message. Show Alert
You can configure an alert box when you create it with dhx.alert():
dhx.alert({
header:"Alert Header",
text:"Alert text",
buttonsAlignment:"center"
});
Related sample: Message. Alert and confirm configuration
See the full list of configuration properties that the alert box constructor accepts.
Confirm box

Related sample: Message. Show Confirm
You can configure a confirm box when you create it with dhx.confirm():
dhx.confirm({
header:"Confirm Header",
text:"Confirm text",
buttons:["cancel", "apply"],
buttonsAlignment:"center"
});
Related sample: Message. Alert and confirm configuration
See the full list of configuration properties that the confirm box constructor accepts.
Working with confirm
dhx.confirm() returns a Promise. Pass a callback to its then() method to find out which button the user clicked:
dhx.confirm({
header: "confirm the action",
text: "can you apply?",
buttons: ["cancel", "apply"]
}).then(function(answer){
if (answer){
console.log("confirmed")
}
else {
console.log("cancelled")
}
});
Tooltip
Related sample: Message. Show Tooltip
You can configure a tooltip when you create it with dhx.tooltip():
dhx.tooltip("Tooltip From Right", {
node: "fourth",
position: "right",
margin: 8
});
Related Samples:
See the full list of configuration properties that the tooltip constructor accepts.
Smart positioning
If the tooltip target is close to an edge of the browser window, the tooltip appears on the opposite side of the target.
In the image below, the target is adjacent to the right side of the screen. The tooltip has the position:"right" property in its configuration object but appears to the left of the target.
Tooltip API
Use the following methods to switch tooltips off and on:
- To switch tooltips off, call the
disableTooltip()method:
dhx.disableTooltip();
- To switch tooltips on again, call the
enableTooltip()method:
dhx.enableTooltip();