See also
setYear method
Sets the year for a specified date.
Syntax
dateObjectName.setYear(yearValue)
dateObjectName is either the name of a date object or a property of an existing object.
yearValue is an integer greater than 1900 or a property of an existing object.
Method of
Examples
theBigDay.setYear(96)
See also
sin method
Returns the sine of a number.
Syntax
Math.sin(number)
number is a numeric expression or a property of an existing object, representing the size of an angle in radians.
Method of
Description
The sin method returns a numeric value between -1 and 1, which represents the sine of the angle.
Examples
//Displays the value 1
document.write("The sine of pi/2 radians is " +
Math.sin(Math.PI/2))
//Displays the value 1.224606353822377e-016
document.write("<P>The sine of pi radians is " +
Math.sin(Math.PI))
//Displays the value 0
document.write("<P>The sine of 0 radians is " +
Math.sin(0))
See also
small method
Causes a string to be displayed in a small font as if it were in a <SMALL> tag.
Syntax
stringName.small()
stringName is any string or a property of an existing object.
Method of
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"
document.write(worldString.small())
document.write("<P>" + worldString.big())
document.write("<P>" + worldString.fontsize(7))
The previous example produces the same output as the following HTML:
<SMALL>Hello, world</SMALL> <P><BIG>Hello, world</BIG> <P><FONTSIZE=7>Hello, world</FONTSIZE>
See also
sqrt method
Returns the square root of a number.
Syntax
Math.sqrt(number)number is any non-negative numeric expression or a property of an existing object.
Method of
Description
If the value of number is outside the suggested range, the return value is always 0.
Examples
//Displays the value 3
document.write("The square root of 9 is " + Math.sqrt(9))
//Displays the value 1.414213562373095
document.write("<P>The square root of 2 is " + Math.sqrt(2))
//Displays the value 0 because the argument is out of range
document.write("<P>The square root of -1 is " + Math.sqrt(-1))
SQRT1_2 property
The square root of one-half; equivalently, one over the square root of two, approximately 0.707.
Syntax
Math.SQRT1_2
Property of
Description
Because SQRT1_2 is a constant, it is a read-only property of Math.
Examples
The following example displays 1 over the square root of 2:
document.write("1 over the square root of 2 is " + Math.SQRT1_2)
See also
SQRT2 property
The square root of two, approximately 1.414.
Syntax
Math.SQRT2
Property of
Description
Because SQRT2 is a constant, it is a read-only property of Math.
Examples
The following example displays the square root of 2:
document.write("The square root of 2 is " + Math.SQRT2)
See also
status property
Specifies a priority or transient message in the status bar at the bottom of the window, such as the message that appears when a mouseOver event occurs over an anchor.
Syntax
windowReference.status
windowReference is a valid way of referring to a window, as described in the window object.
Property of
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:
In the above example, the status property of the window is assigned to the window's self property, as self.status. As this example shows, you must return true to set the status property in the onMouseOver event handler.
See also
strike method
Causes a string to be displayed as struck out text as if it were in a <STRIKE> tag.
Syntax
stringName.strike()
stringName is any string or a property of an existing object.
Method of
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"
document.write(worldString.blink())
document.write("<P>" + worldString.bold())
document.write("<P>" + worldString.italics())
document.write("<P>" + worldString.strike())
The previous example produces the same output as the following HTML:
<BLINK>Hello, world</BLINK> <P><B>Hello, world</B> <P><I>Hello, world</I> <P><STRIKE>Hello, world</STRIKE>
See also
string object
A series of characters.
Syntax
To use a string object:
1. stringName.propertyName 2. stringName.methodName(parameters)stringName is the name of a string variable.
propertyName is one of the properties listed below.
methodName is one of the methods listed below.
Property of
Description
The string object is a built-in JavaScript object.
A string can be represented as a literal enclosed by single or double quotes; for example, "Netscape" or 'Netscape'.
Properties
Methods
Event handlers
Examples
The following statement creates a string variable.
See also
sub method
Causes a string to be displayed as a subscript as if it were in a <SUB> tag.
Syntax
stringName.sub()
stringName is any string or a property of an existing object.
Method of
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"
var subText="subscript"
document.write("This is what a " + superText.sup() + " looks like.")
document.write("<P>This is what a " + subText.sub() + " looks like.")
The previous example produces the same output as the following HTML:
This is what a <SUP>superscript</SUP> looks like. <P>This is what a <SUB>subscript</SUB> looks like.
See also
sup method
submit method
Submits a form.
Syntax
formName.submit()
formName is the name of any form or an element in the forms array.
Method of
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.
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
A submit button on an HTML form. A submit button causes a form to be submitted.
Syntax
To define a submit button, use standard HTML syntax with the addition of the onClick event handler:
<INPUT TYPE="submit" NAME="submitName" VALUE="buttonText" [onClick="handlerText"]>NAME="submitName" specifies the name of the submit object. You can access this value using the name property.
VALUE="buttonText" specifies the label to display on the button face. You can access this value using the value property.
To use a submit object's properties and methods:
1. submitName.propertyName 2. submitName.methodName(parameters) 3. formName.elements[index].propertyName 4. formName.elements[index].methodName(parameters)submitName is the value of the NAME attribute of a submit object.
formName is either the value of the NAME attribute of a form object or an element in the forms array.
index is an integer representing a submit object on a form.
propertyName is one of the properties listed below.
methodName is one of the methods listed below.
Property of
Description
A submit object on a form looks as follows:
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.
Properties
Methods
Event handlers
Examples
The following example creates a submit object called submit_button. The text "Done" is displayed on the face of the button.
See also the examples for the form object.
See also
substring method
Returns a subset of a string object.
Syntax
stringName.substring(indexA, indexB)
stringName is any string or a property of an existing object.
indexA is any integer from 0 to stringName.length - 1, or a property of an existing object.
indexB is any integer from 0 to stringName.length - 1, or a property of an existing object.
Method of
Description
Characters in a string are indexed from left to right. The index of the first character is 0, and the index of the last character is stringName.length - 1.
If indexA is less than indexB, the substring method returns the subset starting with the character at indexA and ending with the character before indexB. If indexA is greater than indexB, the substring method returns the subset starting with the character at indexB and ending with the character before indexA. If indexA is equal to indexB, the substring method returns the empty string.
Examples
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))
sup method
Causes a string to be displayed as a superscript as if it were in a <SUP> tag.
Syntax
stringName.sup()
stringName is any string or a property of an existing object.
Method of
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"
var subText="subscript"
document.write("This is what a " + superText.sup() + " looks like.")
document.write("<P>This is what a " + subText.sub() + " looks like.")
The previous example produces the same output as the following HTML:
This is what a <SUP>superscript</SUP> looks like. <P>This is what a <SUB>subscript</SUB> looks like.
See also
