mirror of
https://github.com/google/blockly.git
synced 2026-01-07 17:10:11 +01:00
108 lines
3.3 KiB
TypeScript
108 lines
3.3 KiB
TypeScript
/**
|
|
* @license
|
|
* Copyright 2021 Google LLC
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
/**
|
|
* @fileoverview Wrapper functions around JS functions for showing
|
|
* alert/confirmation dialogs.
|
|
*/
|
|
|
|
'use strict';
|
|
|
|
/**
|
|
* Wrapper functions around JS functions for showing alert/confirmation dialogs.
|
|
* @namespace Blockly.dialog
|
|
*/
|
|
goog.module('Blockly.dialog');
|
|
|
|
let alertImplementation = function(message, opt_callback) {
|
|
window.alert(message);
|
|
if (opt_callback) {
|
|
opt_callback();
|
|
}
|
|
};
|
|
|
|
let confirmImplementation = function(message, callback) {
|
|
callback(window.confirm(message));
|
|
};
|
|
|
|
let promptImplementation = function(message, defaultValue, callback) {
|
|
callback(window.prompt(message, defaultValue));
|
|
};
|
|
|
|
/**
|
|
* Wrapper to window.alert() that app developers may override via setAlert to
|
|
* provide alternatives to the modal browser window.
|
|
* @param {string} message The message to display to the user.
|
|
* @param {function()=} opt_callback The callback when the alert is dismissed.
|
|
* @alias Blockly.dialog.alert
|
|
*/
|
|
const alert = function(message, opt_callback) {
|
|
alertImplementation(message, opt_callback);
|
|
};
|
|
exports.alert = alert;
|
|
|
|
/**
|
|
* Sets the function to be run when Blockly.dialog.alert() is called.
|
|
* @param {!function(string, function()=)} alertFunction The function to be run.
|
|
* @see Blockly.dialog.alert
|
|
* @alias Blockly.dialog.setAlert
|
|
*/
|
|
const setAlert = function(alertFunction) {
|
|
alertImplementation = alertFunction;
|
|
};
|
|
exports.setAlert = setAlert;
|
|
|
|
/**
|
|
* Wrapper to window.confirm() that app developers may override via setConfirm
|
|
* to provide alternatives to the modal browser window.
|
|
* @param {string} message The message to display to the user.
|
|
* @param {!function(boolean)} callback The callback for handling user response.
|
|
* @alias Blockly.dialog.confirm
|
|
*/
|
|
const confirm = function(message, callback) {
|
|
confirmImplementation(message, callback);
|
|
};
|
|
exports.confirm = confirm;
|
|
|
|
/**
|
|
* Sets the function to be run when Blockly.dialog.confirm() is called.
|
|
* @param {!function(string, !function(boolean))} confirmFunction The function
|
|
* to be run.
|
|
* @see Blockly.dialog.confirm
|
|
* @alias Blockly.dialog.setConfirm
|
|
*/
|
|
const setConfirm = function(confirmFunction) {
|
|
confirmImplementation = confirmFunction;
|
|
};
|
|
exports.setConfirm = setConfirm;
|
|
|
|
/**
|
|
* Wrapper to window.prompt() that app developers may override via setPrompt to
|
|
* provide alternatives to the modal browser window. Built-in browser prompts
|
|
* are often used for better text input experience on mobile device. We strongly
|
|
* recommend testing mobile when overriding this.
|
|
* @param {string} message The message to display to the user.
|
|
* @param {string} defaultValue The value to initialize the prompt with.
|
|
* @param {!function(?string)} callback The callback for handling user response.
|
|
* @alias Blockly.dialog.prompt
|
|
*/
|
|
const prompt = function(message, defaultValue, callback) {
|
|
promptImplementation(message, defaultValue, callback);
|
|
};
|
|
exports.prompt = prompt;
|
|
|
|
/**
|
|
* Sets the function to be run when Blockly.dialog.prompt() is called.
|
|
* @param {!function(string, string, !function(?string))} promptFunction The
|
|
* function to be run.
|
|
* @see Blockly.dialog.prompt
|
|
* @alias Blockly.dialog.setPrompt
|
|
*/
|
|
const setPrompt = function(promptFunction) {
|
|
promptImplementation = promptFunction;
|
|
};
|
|
exports.setPrompt = setPrompt;
|