JScript - Modified Alert Box

Now Available In jPaq!!!

Now this function is available in the custom JScript library, jPaq. The nice thing about jPaq is that everything is documented and the library that you download is specifically tailored to your needs. Click here to create your own free jPaq today!

Purpose:

Give the scripter the ability to use the alert(...) function in any stand-alone JScript file.

Download:

You can find this helpful 424 byte script here.

Parameters:

alert(message [, title [, options [, duration]]])

description	The message that appears in the alert box.
title	Optional. The title of the alert box. By default, this value is the file name of the script.
options	Optional. The button type and icon type you would like to appear in the alert box. By default, this value is set to alert.Exclamation + alert.OKOnly.
duration	Optional. The duration in seconds that the alert box will appear before ending and returning alert.Timeout. If none is specified, the alert box will never timeout.

Returns:

If a timeout occurs, alert.Timeout is returned. If a timeout doesn't occur, the response constant associated with the button pressed will be returned.

Constants:

Button Types

OKOnly - Show the message box with an "OK" button.
OKCancel - Show the message box with an "OK" and "Cancel" buttons.
AbortRetryIgnore - Show the message box with an "Abort", "Retry" and "Ignore" buttons.
YesNoCancel - Show the message box with an "Yes", "No" and "Cancel" buttons.
YesNo - Show the message box with an "Yes" and "No" buttons.
RetryCancel - Show the message box with an "Retry" and "Cancel" buttons.

Icon Types

Critical - Show the "Stop Mark" icon.
Question - Show the "Question Mark" icon.
Exclamation - Show the "Exclamation Mark" icon.
Information - Show the "Information Mark" icon.

Responses

Timeout - Returned if the message box timed out.
OK - Returned when the "OK" button is pressed.
Cancel - Returned when the "Cancel" button is pressed.
Abort - Returned when the "Abort" button is pressed.
Retry - Returned when the "Retry" button is pressed.
Ignore - Returned when the "Ignore" button is pressed.
Yes - Returned when the "Yes" button is pressed.
No - Returned when the "No" button is pressed.

Example Code:

NOTE: All of these examples presuppose that the code from ModifiedAlertBox.js is encountered first.

The following code will display a typical alert box, almost identical to the one displayed when clicking here:

alert("Hello world!!!");

The following code will display an alert box with a message of "Where in the world is Carmen Sandiego?" and a title of "Carmen Sandiego":

alert("Where in the world is Carmen Sandiego?", "Carmen Sandiego");

The following code will display an alert box with a message of "I am the computer which means I am always right.", a title of "Computer Rules", and the Information icon:

alert("I am the computer which means I am always right.", "Computer Rules", alert.Information);

The following code will display an alert box with a message of "Is your PC slow?", a title of "PC Speed", the Question icon, and the "Yes" and "No" buttons. After the user picks one of the buttons, he or she will be informed of which button was chosen:

if(alert("Is your PC slow?", "PC Speed", alert.YesNo + alert.Information) == alert.Yes)
	alert("I see that you believe your PC is slow.  I really wish I could help.",
		"Slow PC", alert.Information);
else
	alert("I am glad to hear that you don't think your PC is slow.",
		"PC Isn't Slow", alert.Information);

The following code will display an alert box with a message of "Your PC couldn't download the Internet.", a title of "Download Unsucessful", the Exclamation icon, and the "Retry" and "Cancel" buttons. If the user waits more than five seconds, the alert box will time out and a new message will be displayed. If the user doesn't let the alert box timeout, an appropriate message will displayed, making it obvious which button was clicked:

switch(alert("Your PC couldn't download the Internet.", "Download Unsucessful",
	alert.RetryCancel + alert.Exclamation, 5))
{
	case alert.Retry:
		alert("Sorry, but I think that it would be a waste of both your time and my"
			+ " time if I try to download the Internet.", "Can't Retry Download",
			alert.Critical);
		break;
	case alert.Cancel:
		alert("Good choice, there is no reason to have all of the junk on the web"
			+ " anyway.", "Cancel Download", alert.Information);
		break;
	case alert.Timeout:
		alert("I guess you don't care what happens.", "Timeout Occurred");
}

Related Search Results

JavaScript - GET Object Emulation:
Learn how to emulate the GET object with JavaScript.
JavaScript Snippet - getAbsPathFor(...):
Get the absolute path from a given relative path.
Wormbites 2008 (Desktop Version):
The ultimate Snake game with multiple brain-teasing levels. You can also custom design you own levels.
JXtension - A Small, Yet Powerful JavaScript Library:
JXtension is a small, yet powerful JavaScript library.
JavaScript - Dynamic Interaction:
Learn how to handle events with plain JavaScript.