windowReference.scroll(x-coordinate,y-coordinate)
x-coordinate is an integer representing the x-coordinate in pixels.
y-coordinate is an integer representing the y-coordinate in pixels.
Method of
window object
Implemented in
Navigator 3.0
Description
JavaScript does not reflect document dimensions in pixels, so when using the scroll method, you must hardcode the x and y coordinates. A document's upper left coordinates are 0,0.
Examples
Example 1: Scroll the current window. The following example scrolls the current window to the coordinates 50,100.
window.scroll(50,100)
Example 2: Scroll a different window. The following code, which exists in one frame, scrolls a second frame. Two Text objects let the user specify the x and y coordinates. When the user clicks the Go button, the document in frame2 scrolls to the specified coordinates.
<SCRIPT>
function scrollIt(form) {
var x = parseInt(form.x.value)
var y = parseInt(form.y.value)
parent.frame2.scroll(x, y)
}
</SCRIPT>
<BODY>
<FORM NAME="myForm">
<P><B>Specify the coordinates to scroll to:</B>
<BR>Horizontal:
<INPUT TYPE="text" NAME=x VALUE="0" SIZE=4>
<BR>Vertical:
<INPUT TYPE="text" NAME=y VALUE="0" SIZE=4>
<BR><INPUT TYPE="button" VALUE="Go"
onClick="scrollIt(document.myForm)">
</FORM>
1. links[index].search
2. location.search
3. areaName.search
?x=7&y=5You can set the search property at any time, although it is safer to set the href property to change a location. If the search that you specify cannot be found in the current location, you will get an error. In event handlers, you must specify
window.location.search instead of simply using location.search. Due to the scoping of static objects in JavaScript, a call to location without specifying an object name is equivalent to document.location, which is a synonym for document.URL.
See Section 3.3 of RFC 1738 for complete information about the search.
Examples
In the following example, the window.open statement creates a window called newWindow and loads the specified URL into it. The document.write statements display all the properties of newWindow.location in a window called msgWindow.
newWindow=window.open
The previous example displays the following output:
("http://guide-p.infoseek.com/WW/NS/Titles?qt=RFC+1738+&col=WW")
msgWindow.document.write("newWindow.location.href = " +
newWindow.location.href + "<P>")
msgWindow.document.write("newWindow.location.protocol = " +
newWindow.location.protocol + "<P>")
msgWindow.document.write("newWindow.location.host = " +
newWindow.location.host + "<P>")
msgWindow.document.write("newWindow.location.hostName = " +
newWindow.location.hostName + "<P>")
msgWindow.document.write("newWindow.location.port = " +
newWindow.location.port + "<P>")
msgWindow.document.write("newWindow.location.pathname = " +
newWindow.location.pathname + "<P>")
msgWindow.document.write("newWindow.location.hash = " +
newWindow.location.hash + "<P>")
msgWindow.document.write("newWindow.location.search = " +
newWindow.location.search + "<P>")
msgWindow.document.close()newWindow.location.href =
http://guide-p.infoseek.com/WW/NS/Titles?qt=RFC+1738+&col=WW
newWindow.location.protocol = http:
newWindow.location.host = guide-p.infoseek.com
newWindow.location.hostName = guide-p.infoseek.com
newWindow.location.port =
newWindow.location.pathname = /WW/NS/Titles
newWindow.location.hash =
newWindow.location.search = ?qt=RFC+1738+&col=WW See also
hash, host, hostname, href, pathname, port, protocol properties
1. passwordName.select()
2. textName.select()
3. textareaName.select()
Implemented in
Navigator 2.0
Description
Use the select method to highlight the input area of a form element. You can use the select method with the focus method to highlight a field and position the cursor for a user response.
Examples
In the following example, the checkPassword function confirms that a user has entered a valid password. If the password is not valid, the select method highlights the password field and the focus method returns focus to it so the user can re-enter the password.
function checkPassword(userPass) {
This example assumes that the password is defined as
if (badPassword) {
alert("Please enter your password again.")
userPass.focus()
userPass.select()
}
}<INPUT TYPE="password" NAME="userPass">
See also
blur, focus methods
<SELECT
NAME="selectName"
[SIZE="integer"]
[MULTIPLE]
[onBlur="handlerText"]
[onChange="handlerText"]
[onFocus="handlerText"]>
<OPTION VALUE="optionValue" [SELECTED]> textToDisplay
[ ... <OPTION> textToDisplay]
</SELECT>
optionName = new Option([text, value, defaultSelected, selected])To add the new option to an existing Select object:
selectName.options[index1]=optionNameTo delete an option from a Select object:
selectName.options[index1] = nullTo use a Select object's properties and methods:
1. selectName.propertyNameTo use an option's properties:
2. selectName.methodName(parameters)
3. formName.elements[index].propertyName
4. formName.elements[index].methodName(parameters)
1. selectName.options[index1].propertyName
2. formName.elements[index2].options[index1].propertyName
3. optionName.propertyName
A Select object is a form element and must be defined within a <FORM> tag.
musicStyle.options[0], musicStyle.options[1], and musicStyle.options[2].
To use the options array:
1. selectName.optionsselectName is either the value of the NAME attribute of a Select object or an element in the elements array. index is an integer representing an option in a Select object. To obtain the number of options in a Select object, use the length property of either the options array or the Select object:
2. selectName.options[index]
3. selectName.options.length
1. selectName.lengthThe Select object has properties that you can access only through the options array. These properties are listed below. Each element in the options array represents a Select option; the value returned by selectName.options represents the full HTML statement for the selectName object. Elements in the options array are read-only. For example, the statement
2. selectName.options.length
selectName.options[0]="guitar" has no effect.
For Select objects that can have multiple selections (the <SELECT> tag has the MULTIPLE attribute), you have to loop and test each option individually:
for (var i = 0; i < select.options.length; i++) {
if (select.options[i].selected)
// Statements to perform if option is selected
...
}
document.myForm.musicTypes.selectedIndex = i
document.myForm.musicTypes.options[i].selected = true
<SELECT name="userChoice">You can set the text of the ith item in the selection based on text entered in a text field named whatsNew as follows:
<OPTION>Choice 1
<OPTION>Choice 2
<OPTION>Choice 3
</SELECT>
myform.userChoice.options[i].text = myform.whatsNew.valueYou do not need to reload or refresh after changing an option's text. For example, in the following form, the user can enter some text in the first text field and then enter a number between 0 and 2 (inclusive) in the second text field. When the user clicks the button, the text will be substituted for the indicated option number and that option is selected.
The code for this example looks as follows:
<SCRIPT>
function updateList(theForm, i) {
theForm.userChoice.options[i].text = theForm.whatsNew.value
theForm.userChoice.options[i].selected = true
}
</SCRIPT>
<FORM>
<SELECT name="userChoice">
<OPTION>Choice 1
<OPTION>Choice 2
<OPTION>Choice 3
</SELECT>
<BR>
New text for the option: <INPUT TYPE="text" NAME="whatsNew">
<BR>
Option to change (0, 1, or 2): <INPUT TYPE="text" NAME="idx">
<BR>
<INPUT TYPE="button" VALUE="Change Selection"
onClick="updateList(this.form, this.form.idx.value)">
</FORM>
history.go(0). This statement must be last. When the document reloads, variables are lost if not saved in cookies or form element values.
history.go(0). This statement must be last. When the document reloads, variables are lost if not saved in cookies or form element values.
The options array has the following properties:
| Property |
Description
|
length
|
Reflects the number of options in a Select object
|
selectedIndex
|
Reflects the index of the selected option
| |
|---|
Each element of the options array has the following properties:
Objects created with the Option() constructor have the following properties:
Methods
The Select object has the following methods:
|
|
|
Choose the music type for your free CD:Example 2. The following example displays two selection lists that let the user choose a month and day. These selection lists are initialized to the current date. The user can change the month and day by using the selection lists or by choosing preset dates from radio buttons. Text fields on the form display the values of the Select object's properties and indicate the date chosen and whether it is Cinco de Mayo.
<SELECT NAME="music_type_single">
<OPTION SELECTED> R&B
<OPTION> Jazz
<OPTION> Blues
<OPTION> New Age
</SELECT>
<P>Choose the music types for your free CDs:
<BR><SELECT NAME="music_type_multi" MULTIPLE>
<OPTION SELECTED> R&B
<OPTION> Jazz
<OPTION> Blues
<OPTION> New Age
</SELECT>
<HTML>Example 3. Add an option using the Option() constructor. The following example creates two Select objects, one without the MULTIPLE attribute and one with. No options are initially defined for either object. When the user clicks a button associated with the Select object, the populate function creates four options for the Select object and selects the first option.
<HEAD>
<TITLE>Select object example</TITLE>
</HEAD>
<BODY>
<SCRIPT>
var today = new Date()
//---------------
function updatePropertyDisplay(monthObj,dayObj) {
// Get date strings
var monthInteger, dayInteger, monthString, dayString
monthInteger=monthObj.selectedIndex
dayInteger=dayObj.selectedIndex
monthString=monthObj.options[monthInteger].text
dayString=dayObj.options[dayInteger].text
// Display property values
document.selectForm.textFullDate.value=monthString + " " + dayString
document.selectForm.textMonthLength.value=monthObj.length
document.selectForm.textDayLength.value=dayObj.length
document.selectForm.textMonthName.value=monthObj.name
document.selectForm.textDayName.value=dayObj.name
document.selectForm.textMonthIndex.value=monthObj.selectedIndex
document.selectForm.textDayIndex.value=dayObj.selectedIndex
// Is it Cinco de Mayo?
if (monthObj.options[4].selected && dayObj.options[4].selected)
document.selectForm.textCinco.value="Yes!"
else
document.selectForm.textCinco.value="No"
}
</SCRIPT>
<!--------------->
<FORM NAME="selectForm">
<P><B>Choose a month and day:</B>
Month: <SELECT NAME="monthSelection"
onChange="updatePropertyDisplay(this,document.selectForm.daySelection)">
<OPTION> January <OPTION> February <OPTION> March
<OPTION> April <OPTION> May <OPTION> June
<OPTION> July <OPTION> August <OPTION> September
<OPTION> October <OPTION> November <OPTION> December
</SELECT>
Day: <SELECT NAME="daySelection"
onChange="updatePropertyDisplay(document.selectForm.monthSelection,this)">
<OPTION> 1 <OPTION> 2 <OPTION> 3 <OPTION> 4 <OPTION> 5
<OPTION> 6 <OPTION> 7 <OPTION> 8 <OPTION> 9 <OPTION> 10
<OPTION> 11 <OPTION> 12 <OPTION> 13 <OPTION> 14 <OPTION> 15
<OPTION> 16 <OPTION> 17 <OPTION> 18 <OPTION> 19 <OPTION> 20
<OPTION> 21 <OPTION> 22 <OPTION> 23 <OPTION> 24 <OPTION> 25
<OPTION> 26 <OPTION> 27 <OPTION> 28 <OPTION> 29 <OPTION> 30
<OPTION> 31
</SELECT>
<P><B>Set the date to: </B>
<INPUT TYPE="radio" NAME="dateChoice"
onClick="
monthSelection.selectedIndex=0;
daySelection.selectedIndex=0;
updatePropertyDisplay
document.selectForm.monthSelection,document.selectForm.daySelection)">
New Year's Day
<INPUT TYPE="radio" NAME="dateChoice"
onClick="
monthSelection.selectedIndex=4;
daySelection.selectedIndex=4;
updatePropertyDisplay
(document.selectForm.monthSelection,document.selectForm.daySelection)">
Cinco de Mayo
<INPUT TYPE="radio" NAME="dateChoice"
onClick="
monthSelection.selectedIndex=5;
daySelection.selectedIndex=20;
updatePropertyDisplay
(document.selectForm.monthSelection,document.selectForm.daySelection)">
Summer Solstice
<P><B>Property values:</B>
<BR>Date chosen: <INPUT TYPE="text" NAME="textFullDate" VALUE="" SIZE=20">
<BR>monthSelection.length<INPUT TYPE="text" NAME="textMonthLength" VALUE="" SIZE=20">
<BR>daySelection.length<INPUT TYPE="text" NAME="textDayLength" VALUE="" SIZE=20">
<BR>monthSelection.name<INPUT TYPE="text" NAME="textMonthName" VALUE="" SIZE=20">
<BR>daySelection.name<INPUT TYPE="text" NAME="textDayName" VALUE="" SIZE=20">
<BR>monthSelection.selectedIndex
<INPUT TYPE="text" NAME="textMonthIndex" VALUE="" SIZE=20">
<BR>daySelection.selectedIndex<INPUT TYPE="text" NAME="textDayIndex" VALUE="" SIZE=20">
<BR>Is it Cinco de Mayo? <INPUT TYPE="text" NAME="textCinco" VALUE="" SIZE=20">
<SCRIPT>
document.selectForm.monthSelection.selectedIndex=today.getMonth()
document.selectForm.daySelection.selectedIndex=today.getDate()-1
updatePropertyDisplay(document.selectForm.monthSelection,document.selectForm.daySelection)
</SCRIPT>
</FORM>
</BODY>
</HTML>
<SCRIPT>Example 4. Delete an option. The following function removes an option from a Select object.
function populate(inForm) {
colorArray = new Array("Red", "Blue", "Yellow", "Green")
var option0 = new Option("Red", "color_red")
var option1 = new Option("Blue", "color_blue")
var option2 = new Option("Yellow", "color_yellow")
var option3 = new Option("Green", "color_green")
for (var i=0; i < 4; i++) {
eval("inForm.selectTest.options[i]=option" + i)
if (i==0) {
inForm.selectTest.options[i].selected=true
}
}
history.go(0)
}
</SCRIPT>
<H3>Select Option() constructor</H3>
<FORM>
<SELECT NAME="selectTest"></SELECT><P>
<INPUT TYPE="button" VALUE="Populate Select List" onClick="populate(this.form)">
<P>
</FORM>
<HR>
<H3>Select-Multiple Option() constructor</H3>
<FORM>
<SELECT NAME="selectTest" multiple></SELECT><P>
<INPUT TYPE="button" VALUE="Populate Select List" onClick="populate(this.form)">
</FORM>
function deleteAnItem(theList,itemNo) {
theList.options[itemNo]=null
history.go(0)
}
See also the examples for the defaultSelected property.
1. selectName.options[index].selected
2. optionName.selected
See also
defaultSelected, index, selectedIndex properties
1. selectName.selectedIndex
2. selectName.options.selectedIndex
Implemented in
Navigator 2.0
Tainted?
Yes
Description
Options in a Select object are indexed in the order in which they are defined, starting with an index of zero. You can set the selectedIndex property at any time. The display of the Select object updates immediately when you set the selectedIndex property. Both forms of the syntax specify the same value. If no option is selected, selectedIndex has a value of -1.
In general, the selectedIndex property is more useful for Select objects that are created without the MULTIPLE attribute. If you evaluate selectedIndex when multiple options are selected, the selectedIndex property specifies the index of the first option only. Setting selectedIndex clears any other options that are selected in the Select object.
The selected property of the Select object's options array is more useful for Select objects that are created with the MULTIPLE attribute. With the selected property, you can evaluate every option in the options array to determine multiple selections, and you can select individual options without clearing the selection of other options.
Examples
In the following example, the getSelectedIndex function returns the selected index in the musicType Select object:
function getSelectedIndex() {
The previous example assumes that the Select object is similar to the following:
return document.musicForm.musicType.selectedIndex
}<SELECT NAME="musicType">
<OPTION SELECTED> R&B
<OPTION> Jazz
<OPTION> Blues
<OPTION> New Age
</SELECT> See also
defaultSelected, index, selected properties
1. self.propertyName
2. self.methodName
Implemented in
Navigator 2.0
Tainted?
No
Description
The self property refers to the current window or frame.
Use the self property to disambiguate a window property from a form or form element of the same name. You can also use the self property to make your code more readable.
The self property is read-only. The value of the self property is
<object nameAttribute>
where nameAttribute is the NAME attribute if self refers to a frame, or an internal reference if self refers to a window.
Examples
In the following example, self.status is used to set the status property of the current window. This usage disambiguates the status property of the current window from a form or form element called "status" within the current window.
<A HREF=""
onClick="this.href=pickRandomURL()"
onMouseOver="self.status='Pick a random URL' ; return true">
Go!</A> See also
window property
dateObjectName.setDate(dayValue)
Implemented in
Navigator 2.0
Examples
The second statement below changes the day for theBigDay to July 24 from its original value.
theBigDay = new Date("July 27, 1962 23:30:00")
theBigDay.setDate(24) See also
getDate method
dateObjectName.setHours(hoursValue)
Implemented in
Navigator 2.0
Examples
theBigDay.setHours(7)
See also
getHours method
dateObjectName.setMinutes(minutesValue)
Implemented in
Navigator 2.0
Examples
theBigDay.setMinutes(45)
See also
getMinutes method
dateObjectName.setMonth(monthValue)
Implemented in
Navigator 2.0
Examples
theBigDay.setMonth(6)
See also
getMonth method
dateObjectName.setSeconds(secondsValue)
Implemented in
Navigator 2.0
Examples
theBigDay.setSeconds(30)
See also
getSeconds method
dateObjectName.setTime(timevalue)
Implemented in
Navigator 2.0
Description
Use the setTime method to help assign a date and time to another Date object.
Examples
theBigDay = new Date("July 1, 1999")
sameAsBigDay = new Date()
sameAsBigDay.setTime(theBigDay.getTime()) See also
getTime method
timeoutID=setTimeout(expression, msec)
Implemented in
Navigator 2.0
Description
The setTimeout method evaluates an expression after a specified amount of time. It does not evaluate the expression repeatedly. For example, if a setTimeout method specifies five seconds, the expression is evaluated after five seconds, not every five seconds.
Examples
Example 1. The following example displays an alert message five seconds (5,000 milliseconds) after the user clicks a button. If the user clicks the second button before the alert message is displayed, the timeout is canceled and the alert does not display.
<SCRIPT LANGUAGE="JavaScript">
Example 2. The following example displays the current time in a Text object. The showtime function, which is called recursively, uses the setTimeout method to update the time every second.
function displayAlert() {
alert("5 seconds have elapsed since the button was clicked.")
}
</SCRIPT>
<BODY>
<FORM>
Click the button on the left for a reminder in 5 seconds;
click the button on the right to cancel the reminder before
it is displayed.
<P>
<INPUT TYPE="button" VALUE="5-second reminder"
NAME="remind_button"
onClick="timerID=setTimeout('displayAlert()',5000)">
<INPUT TYPE="button" VALUE="Clear the 5-second reminder"
NAME="remind_disable_button"
onClick="clearTimeout(timerID)">
</FORM>
</BODY><HEAD>
<SCRIPT LANGUAGE="JavaScript">
<!--
var timerID = null
var timerRunning = false
function stopclock(){
if(timerRunning)
clearTimeout(timerID)
timerRunning = false
}
function startclock(){
// Make sure the clock is stopped
stopclock()
showtime()
}
function showtime(){
var now = new Date()
var hours = now.getHours()
var minutes = now.getMinutes()
var seconds = now.getSeconds()
var timeValue = "" + ((hours > 12) ? hours - 12 : hours)
timeValue += ((minutes < 10) ? ":0" : ":") + minutes
timeValue += ((seconds < 10) ? ":0" : ":") + seconds
timeValue += (hours >= 12) ? " P.M." : " A.M."
document.clock.face.value = timeValue
timerID = setTimeout("showtime()",1000)
timerRunning = true
}
//-->
</SCRIPT>
</HEAD>
<BODY onLoad="startclock()">
<FORM NAME="clock" onSubmit="0">
<INPUT TYPE="text" NAME="face" SIZE=12 VALUE ="">
</FORM>
</BODY> See also
clearTimeout method
dateObjectName.setYear(yearValue)
Implemented in
Navigator 2.0
Examples
theBigDay.setYear(96)
See also
getYear method
Math.sin(number)
Implemented in
Navigator 2.0
Description
The sin method returns a numeric value between -1 and one, which represents the sine of the argument.
Examples
The following function returns the sine of the variable x:
function getSine(x) {
If you pass getSine the value
return Math.sin(x)
}Math.PI/2, it returns 1.
See also
acos, asin, atan, atan2, cos, tan methods
stringName.small()
Implemented in
Navigator 2.0
Description
Use the small method with the write or writeln methods to format and display a string in a document.
Examples
The following example uses string methods to change the size of a string:
var worldString="Hello, world"
The previous example produces the same output as the following HTML:
document.write(worldString.small())
document.write("<P>" + worldString.big())
document.write("<P>" + worldString.fontsize(7))<SMALL>Hello, world</SMALL>
<P><BIG>Hello, world</BIG>
<P><FONTSIZE=7>Hello, world</FONTSIZE> See also
big, fontsize methods
arrayName.sort(compareFunction)
Implemented in
Navigator 3.0
Description
If compareFunction is not supplied, elements are sorted by converting them to strings and comparing strings in lexicographic ("dictionary" or "telephone book," not numerical) order. For example, "80" comes before "9" in lexicographic order, but if you are comparing numbers 9 needs to come before 80.
If compareFunction is supplied, the array elements are sorted according to the return value of the compare function. If a and b are two elements being compared, then:
function compare(a, b) {
if (a is less than b by some ordering criterion)
return -1
if (a is greater than b by the ordering criterion)
return 1
// a must be equal to b
return 0
}
To compare numbers instead of strings, the compare function can simply subtract b from a:
function compareNumbers(a, b) {
return a - b
}
JavaScript uses a stable sort: the index partial order of a and b does not change if a and b are equal. If a's index was less than b's before sorting, it will be after sorting, no matter how a and b move due to sorting.
Note
On some platforms, the sort method does not work. Please see the release notes (after starting Netscape, choose Release Notes from the Help menu).
<SCRIPT>This example produces the following output. As the output shows, when a compare function is used, numbers sort correctly whether they are numbers or numeric strings.
stringArray = new Array("Blue","Humpback","Beluga")
numericStringArray = new Array("80","9","700")
numberArray = new Array(40,1,5,200)
mixedNumericArray = new Array("80","9","700",40,1,5,200)
function compareNumbers(a, b) {
return a - b
}
document.write("<B>stringArray:</B> " + stringArray.join() +"<BR>")
document.write("<B>Sorted:</B> " + stringArray.sort() +"<P>")
document.write("<B>numberArray:</B> " + numberArray.join() +"<BR>")
document.write("<B>Sorted without a compare function:</B> " + numberArray.sort() +"<BR>")
document.write("<B>Sorted with compareNumbers:</B> " + numberArray.sort(compareNumbers) +"<P>")
document.write("<B>numericStringArray:</B> " + numericStringArray.join() +"<BR>")
document.write("<B>Sorted without a compare function:</B> " + numericStringArray.sort() +"<BR>")
document.write("<B>Sorted with compareNumbers:</B> " + numericStringArray.sort(compareNumbers) +"<P>")
document.write("<B>mixedNumericArray:</B> " + mixedNumericArray.join() +"<BR>")
document.write("<B>Sorted without a compare function:</B> " + mixedNumericArray.sort() +"<BR>")
document.write("<B>Sorted with compareNumbers:</B> " + mixedNumericArray.sort(compareNumbers) +"<BR>")
</SCRIPT>
stringArray: Blue,Humpback,Beluga
Sorted: Beluga,Blue,Humpback
numberArray: 40,1,5,200
Sorted without a compare function: 1,200,40,5
Sorted with compareNumbers: 1,5,40,200
numericStringArray: 80,9,700
Sorted without a compare function: 700,80,9
Sorted with compareNumbers: 9,80,700
mixedNumericArray: 80,9,700,40,1,5,200
Sorted without a compare function: 1,200,40,5,700,80,9
Sorted with compareNumbers: 1,5,9,40,80,200,700
stringName.split([separator])
Implemented in
Navigator 3.0
Description
The split method returns the new array.
Examples
The following example defines a function that splits a string into an array of strings using the specified separator. After splitting the string, the function displays messages indicating the original string (before the split), the separator used, the number of elements in the array, and the individual array elements.
function splitString (stringToSplit,separator) {
This example produces the following output:
arrayOfStrings = stringToSplit.split(separator)
document.write ('<P>The original string is: "' + stringToSplit + '"')
document.write ('<BR>The separator is: "' + separator + '"')
document.write ("<BR>The array has " + arrayOfStrings.length + " elements: ")
for (var i=0; i < arrayOfStrings.length; i++) {
document.write (arrayOfStrings[i] + " / ")
}
}
var tempestString="Oh brave new world that has such people in it."
var monthString="Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec"
var space=" "
var comma=","
splitString(tempestString,space)
splitString(tempestString)
splitString(monthString,comma)The original string is: "Oh brave new world that has such people in it."
The separator is: " "
The array has 10 elements: Oh / brave / new / world / that / has / such / people / in / it. /
The original string is: "Oh brave new world that has such people in it."
The separator is: "undefined"
The array has 1 elements: Oh brave new world that has such people in it. /
The original string is: "Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec"
The separator is: ","
The array has 12 elements: Jan / Feb / Mar / Apr / May / Jun / Jul / Aug / Sep / Oct / Nov / Dec / See also
charAt, indexOf, lastIndexOf methods
Math.sqrt(number)
Implemented in
Navigator 2.0
Description
If the value of number is outside the required range, sqrt returns zero.
Examples
The following function returns the square root of the variable x:
function getRoot(x) {
If you pass getRoot the value nine, it returns three; if you pass it the value two, it returns 1.414213562373095.
return Math.sqrt(x)
}
Math.SQRT1_2
Implemented in
Navigator 2.0
Tainted?
No
Description
Because SQRT1_2 is a constant, it is a read-only property of Math.
Examples
The following function returns one over the square root of two:
function getRoot1_2() {
return Math.SQRT1_2
} See also
E, LN2, LN10, LOG2E, LOG2E, PI, SQRT2 properties
Math.SQRT2
Implemented in
Navigator 2.0
Tainted?
No
Description
Because SQRT2 is a constant, it is a read-only property of Math.
Examples
The following function returns the square root of two:
function getRoot2() {
return Math.SQRT2
} See also
E, LN2, LN10, LOG2E, LOG2E, PI, SQRT1_2 properties
imageName.src
Implemented in
Navigator 3.0
Tainted?
No
Description
The src property initially reflects the SRC attribute of the <IMG> tag. Setting the src property begins loading the new URL into the image area (and aborts the transfer of any image data that is already loading into the same area). Therefore, if you plan to alter the lowsrc property, you should do so before setting the src property. If the URL in the src property references an image that is not the same size as the image cell it is loaded into, the source image is scaled to fit.
When you change the src property of a displayed image, the new image you specify is displayed in the area defined for the original image. For example, suppose an Image object originally displays the file beluga.gif:
<IMG NAME="myImage" SRC="beluga.gif" ALIGN="left">
If you set myImage.src='seaotter.gif', the image seaotter.gif is scaled to fit in the same space originally used by beluga.gif, even if seaotter.gif is not the same size as beluga.gif.
You can change the src property at any time.
Examples
The following example displays an image and three radio buttons. The user can click the radio buttons to choose which image is displayed. Each image also uses the lowsrc property to display a low-resolution image.
<SCRIPT>
See also the examples for the Image object.
function displayImage(lowRes,highRes) {
document.images[0].lowsrc=lowRes
document.images[0].src=highRes
}
</SCRIPT>
<FORM NAME="imageForm">
<B>Choose an image:</B>
<BR><INPUT TYPE="radio" NAME="imageChoice" VALUE="image1" CHECKED
onClick="displayImage('f15el.gif','f15e.gif')">F-15 Eagle
<BR><INPUT TYPE="radio" NAME="imageChoice" VALUE="image2"
onClick="displayImage('f15e2l.gif','f15e2.gif')">F-15 Eagle 2
<BR><INPUT TYPE="radio" NAME="imageChoice" VALUE="image3"
onClick="displayImage('ah64l.gif','ah64.gif')">AH-64 Apache
<BR>
<IMG NAME="aircraft" SRC="f15e.gif" LOWSRC="f15el.gif" ALIGN="left" VSPACE="10"><BR>
</FORM> See also
complete, lowsrc properties
windowReference.status
Implemented in
Navigator 2.0
Tainted?
Yes
Description
Do not confuse the status property with the defaultStatus property. The defaultStatus property reflects the default message displayed in the status bar.
You can set the status property at any time. You must return true if you want to set the status property in the onMouseOver event handler.
Examples
Suppose you have created a JavaScript function called pickRandomURL that lets you select a URL at random. You can use the onClick event handler of an anchor to specify a value for the HREF attribute of the anchor dynamically, and the onMouseOver event handler to specify a custom message for the window in the status property:
<A HREF=""
In the preceding example, the status property of the window is assigned to the window's self property, as
onClick="this.href=pickRandomURL()"
onMouseOver="self.status='Pick a random URL'; return true">
Go!</A>self.status. As this example shows, you must return true to set the status property in the onMouseOver event handler.
See also
defaultStatus property
stringName.strike()
Implemented in
Navigator 2.0
Description
Use the strike method with the write or writeln methods to format and display a string in a document.
Examples
The following example uses string methods to change the formatting of a string:
var worldString="Hello, world"
The previous example produces the same output as the following HTML:
document.write(worldString.blink())
document.write("<P>" + worldString.bold())
document.write("<P>" + worldString.italics())
document.write("<P>" + worldString.strike())<BLINK>Hello, world</BLINK>
<P><B>Hello, world</B>
<P><I>Hello, world</I>
<P><STRIKE>Hello, world</STRIKE> See also
blink, bold, italics methods
stringObjectName = new String(string)To use a String object:
1. stringName.propertyName
2. stringName.methodName(parameters)
| Property |
Description
|
length
|
Reflects the length of the string
|
prototype
|
Lets you add properties to a String object.
| |
|---|
Methods
The String object has the following methods:
|
|
|
|
Event handlers
None.
Examples
Example 1: String variable. The following statement creates a string variable:
var last_name = "Schaefer"
Example 2: String object properties. The following statements evaluate to eight, "SCHAEFER," and "schaefer":
last_name.length
Example 3: Pass a string among scripts in different windows or frames. The following code creates two string variables and opens a second window:
last_name.toUpperCase()
last_name.toLowerCase()var lastName = new String("Schaefer")
If the HTML source for the second window (
var firstName = new String ("Jesse")
empWindow=window.open('string2.html','window1','width=300,height=300')string2.html) creates two string variables, empLastName and empFirstName, the following code in the first window assigns values to the second window's variables:
empWindow.empFirstName=firstName
The following code in the first window displays the values of the second window's variables:
empWindow.empLastName=lastNamealert('empFirstName in empWindow is ' + empWindow.empFirstName)
alert('empLastName in empWindow is ' + empWindow.empLastName) See also
Text object, Textarea object
stringName.sub()
Implemented in
Navigator 2.0
Description
Use the sub method with the write or writeln methods to format and display a string in a document.
Examples
The following example uses the sub and sup methods to format a string:
var superText="superscript"
The previous example produces the same output as the following HTML:
var subText="subscript"
document.write("This is what a " + superText.sup() + " looks like.")
document.write("<P>This is what a " + subText.sub() + " looks like.")This is what a <SUP>superscript</SUP> looks like.
<P>This is what a <SUB>subscript</SUB> looks like. See also
sup method
formName.submit()
Implemented in
Navigator 2.0
Description
The submit method submits the specified form. It performs the same action as a submit button.
Use the submit method to send data back to an HTTP server. The submit method returns the data using either "get" or "post," as specified in the method property.
The submit method fails without notice, if the form's action is a mailto:, news:, or snews: URL. This is for security purposes. Users can submit forms with such URLs by clicking a submit button, but a confirming dialog will tell them that they are about to give away private or sensitive information.
Examples
The following example submits a form called musicChoice:
document.musicChoice.submit()
If musicChoice is the first form created, you also can submit it as follows:
document.forms[0].submit()
See also the example for the Form object.
See also
Submit object, onSubmit event handler
<INPUT
TYPE="submit"
NAME="submitName"
VALUE="buttonText"
[onBlur="handlerText"]
[onClick="handlerText"]
[onFocus="handlerText"]>
1. submitName.propertyName
2. submitName.methodName(parameters)
3. formName.elements[index].propertyName
4. formName.elements[index].methodName(parameters)
A Submit object is a form element and must be defined within a <FORM> tag. Clicking a submit button submits a form to the URL specified by the form's action property. This action always loads a new page into the client; it may be the same as the current page, if the action so specifies or is not specified. The submit button's onClick event handler cannot prevent a form from being submitted; instead, use the form's onSubmit event handler or use the submit method instead of a Submit object. See the examples for the Form object. If a form contains only one element, a Text object, then when the user enters a value and presses Return, the form submits. (This is a standard HTML feature.)
| Property |
Description
|
form property
|
Specifies the form containing the Submit object
|
name
|
Reflects the NAME attribute
|
type
|
Reflects the TYPE attribute
|
value
|
Reflects the VALUE attribute
| |
|---|
Methods
The Submit object has the following methods:
|
|
|
<INPUT TYPE="submit" NAME="submitButton" VALUE="Done">See also the examples for the Form object.
See also
Button object, Form object, Reset object; submit method; onSubmit event handler
stringName.substring(indexA, indexB)
Implemented in
Navigator 2.0
Description
Characters in a string are indexed from left to right. The index of the first character is zero, and the index of the last character is stringName.length - 1.
Examples
Example 1. The following example uses substring to display characters from the string "Netscape":
var anyString="Netscape"
//Displays "Net"
document.write(anyString.substring(0,3))
document.write(anyString.substring(3,0))
//Displays "cap"
document.write(anyString.substring(4,7))
document.write(anyString.substring(7,4))
//Displays "Netscap"
document.write(anyString.substring(0,7))
//Displays "Netscape"
document.write(anyString.substring(0,8))
document.write(anyString.substring(0,10))
Example 2. The following example replaces a substring within a string. It will replace both individual characters and substrings. The function call at the end of the example changes the string "Brave New World" into "Brave New Web".
function replaceString(oldS,newS,fullS) {
// Replaces oldS with newS in the string fullS
for (var i=0; i<fullS.length; i++) {
if (fullS.substring(i,i+oldS.length) == oldS) {
fullS = fullS.substring(0,i)+newS+fullS.substring(i+oldS.length,fullS.length)
}
}
return fullS
}replaceString("World","Web","Brave New World")
navigator.mimeTypes[index].suffixes
Implemented in
Navigator 3.0
Tainted?
No
Description
The suffixes property is a string consisting of each valid suffix (typically three letters long) separated by commas. For example, the suffixes for the "audio/x-midi" MIME type are "mid, midi".
suffixes is a read-only property.
Examples
See the examples for the MimeType object.
See also
description, enabledPlugin, type properties
stringName.sup()
Implemented in
Navigator 2.0
Description
Use the sup method with the write or writeln methods to format and display a string in a document.
Examples
The following example uses the sub and sup methods to format a string:
var superText="superscript"
The previous example produces the same output as the following HTML:
var subText="subscript"
document.write("This is what a " + superText.sup() + " looks like.")
document.write("<P>This is what a " + subText.sub() + " looks like.")This is what a <SUP>superscript</SUP> looks like.
<P>This is what a <SUB>subscript</SUB> looks like. See also
sub method