Availability
JavaScript 1.0
Synopsis
window.prompt(message, default)
Arguments
message
The plain-text (not HTML) string to be displayed in the dialog box.
It should ask the user to enter the information you want.
default
A string that is displayed as the default input in the dialog box.
Pass the empty string (") to make
prompt( ) display an empty input box.
Returns
The string entered by the user, the empty string if the user did not
enter a string, or null if the user clicked
Cancel .
Description
The prompt( )
method displays the specified message in a
dialog box that also contains a text input field and OK , Clear ,
and Cancel buttons.
Platform-dependent graphics in the dialog box help indicate to the
user that her input is desired.
If the user clicks the Cancel
button, prompt( ) returns null.
If the user clicks the Clear button,
prompt( ) erases any current text in the input
field. If the user clicks the OK
button, prompt( ) returns the value currently
displayed in the input field.
The dialog box that is displayed by the prompt( )
method is modal -- that is, it blocks all
user input to the main browser window until the user dismisses the
dialog box by clicking on the OK or
Cancel buttons. Since this method
returns a value depending on the user's response to the dialog
box, JavaScript execution pauses in the call to prompt(
), and subsequent statements are not executed until the
user responds to the dialog box.
See Also
Window.alert( ), Window.confirm( )
•
Table of Contents
•
Index
•
Reviews
•
Examples
•
Reader Reviews
•
Errata
JavaScript: The Definitive Guide, 4th Edition
By
David Flanagan
Publisher
: O'Reilly
Pub Date
: November 2001
ISBN
: 0-596-00048-0
Pages
: 936
Slots
: 1
This fourth edition of the definitive reference to
JavaScript, a scripting language that can be embedded
directly in web pages, covers the latest version of the
language, JavaScript 1.5, as supported by Netscape 6 and
Internet Explorer 6. The book also provides complete
coverage of the W3C DOM standard (Level 1 and Level 2),
while retaining material on the legacy Level 0 DOM for
backward compatibility.