controls.js

Dialogs

The dialog functions return immediately (with the dialog's element), and call your function when the user closes the dialog. The messages can contain HTML.

dlgMessage()

dlgMessage(title, string, modal, error, callback, param) shows a message with a Close button.

Parameter	Required	Default	Description
title			Title of the dialog
string			The message (HTML)
modal		false	true stops the user using the rest of the page until the dialog is closed
error		false	true shows the title as an error
callback			Function called as callback(param) when the dialog is closed
param			Passed to callback

dlgAlert()

dlgAlert(s, callback) shows a modal message with the title "Message". It is the same as dlgMessage('Message', s, true, false, callback).

Parameter	Required	Default	Description
s			The message (HTML)
callback			Function called when the dialog is closed

dlgConfirm()

dlgConfirm(string, confirmCallback, param) asks the user to click OK or Cancel.

Parameter	Required	Default	Description
string			The question (HTML)
confirmCallback			Function called as confirmCallback(ok, param), where ok is true for OK and false for Cancel
param			Passed to confirmCallback

dlgQuery()

dlgQuery(string, value, queryCallback, param, size) asks the user to type some text.

Parameter	Required	Default	Description
string			The question (HTML)
value			Initial text in the input field
queryCallback			Function called as queryCallback(answer, param), where answer is the text, or false for Cancel
param			Passed to queryCallback
size		30	Width of the input field, in characters

dlgWait()

dlgWait(time, string, func, param) shows a "Please wait..." dialog with a progress bar, which closes itself.

Parameter	Required	Default	Description
time			How long to show the dialog, in seconds
string			The message (HTML)
func			Function called as func(param) when the dialog closes
param			Passed to func

dlgGeneral() and dlgListBox()

dlgGeneral(p) shows a dialog containing your own HTML, and dlgListBox(p) a dialog holding a list. p is an object with these properties:

Property	Required	Default	Description
html			Contents of the dialog
title			Title of the dialog
iddiv			ID of the dialog's element. An existing element with this ID is removed first
width, height		dlgGeneral: 400, 100. dlgListBox: 400, 200	Initial size, in pixels
minWidth, minHeight		The initial size	Smallest size the user can resize the dialog to
x, y			Initial position, in pixels

Buttons, sliders and progress bars

The Controls class sets up elements with these name attributes when the page loads:

Sliders accept these attributes:

resources/custom_example.html has examples of all these elements.

Functions and variables

function Controls()

Controls.prototype.ctrlHSliderDraw = function(b)

Controls.prototype.ctrlHSliderHandler = function(e)

Controls.prototype.ctrlHSliderSet = function(value)

Controls.prototype.ctrlProgressSet = function(value)

Controls.prototype.ctrlVSliderDraw = function(b)

Controls.prototype.ctrlVSliderHandler = function(e)

Controls.prototype.ctrlVSliderSet = function(value)

Controls.prototype.init = function()

function checkResize(dlg, e)

function ctlInit()

function dlgAlert(s, callback)

function dlgCenter(dlg)

function dlgClose(div)

function dlgConfirm(string, confirmCallback, param)

function dlgFocusableControls(dlg, selector)

function dlgGeneral(p)

function dlgHide(dlg)

function dlgListBox(p)

function dlgLoad(url)

function dlgMessage(title, string, modal, error, callback, param)

function dlgMessageDestroy(b)

function dlgMove(d, x, y)

function dlgQuery(string, value, queryCallback, param, size)

function dlgQueryKeyDown(event, inp)

function dlgShow(dlg, modal, param)

function dlgWait(time, string, func, param)

function drawCloseButton(c, mark)

function updateDlgWaitProgress()

let controls_css = …

var dlgLoadedDialogs = []

let dlgTabHandlerInstalled = false

let dlgWaitDialog

let dlgWaitFunc

let dlgWaitFuncParam

let dlgWaitProgress

let dlgWaitTime