| HiddenA Text object that is suppressed from form display on an HTML form. A Hidden object is used for passing name/value pairs when a form submits.
Client-side object | | Implemented in | Navigator 2.0 Navigator 3.0: added type property |
Created byThe HTML INPUT tag, with "hidden" as the value of the TYPE attribute. For a given form, the JavaScript runtime engine creates appropriate Hidden objects and puts these objects in the elements array of the corresponding Form object. You access a Hidden object by indexing this array. You can index the array either by number or, if supplied, by using the value of the NAME attribute. DescriptionA Hidden object is a form element and must be defined within a FORM tag.A Hidden object cannot be seen or modified by an end user, but you can programmatically change the value of the object by changing its value property. You can use Hidden objects for client/server communication. Property Summary
form
| Specifies the form containing the Hidden object. | name
| Reflects the NAME attribute. | type
| Reflects the TYPE attribute. | value
| Reflects the current value of the Hidden object. |
ExamplesThe following example uses a Hidden object to store the value of the last object the user clicked. The form contains a "Display hidden value" button that the user can click to display the value of the Hidden object in an Alert dialog box.<HTML> <HEAD> <TITLE>Hidden object example</TITLE> </HEAD> <BODY> <B>Click some of these objects, then click the "Display value" button <BR>to see the value of the last object clicked.</B> <FORM NAME="myForm"> <INPUT TYPE="hidden" NAME="hiddenObject" VALUE="None"> <P> <INPUT TYPE="button" VALUE="Click me" NAME="button1" onClick="document.myForm.hiddenObject.value=this.value"> <P> <INPUT TYPE="radio" NAME="musicChoice" VALUE="soul-and-r&b" onClick="document.myForm.hiddenObject.value=this.value"> Soul and R&B <INPUT TYPE="radio" NAME="musicChoice" VALUE="jazz" onClick="document.myForm.hiddenObject.value=this.value"> Jazz <INPUT TYPE="radio" NAME="musicChoice" VALUE="classical" onClick="document.myForm.hiddenObject.value=this.value"> Classical <P> <SELECT NAME="music_type_single" onFocus="document.myForm.hiddenObject.value=this.options[this.selectedIndex].text"> <OPTION SELECTED> Red <OPTION> Orange <OPTION> Yellow </SELECT> <P><INPUT TYPE="button" VALUE="Display hidden value" NAME="button2" onClick="alert('Last object clicked: ' + document.myForm.hiddenObject.value)"> </FORM> </BODY> </HTML> See alsodocument.cookie Properties formAn object reference specifying the form containing this object.
Method of | Hidden | Read-only | | Implemented in | Navigator 2.0 |
DescriptionEach form element has a form property that is a reference to the element's parent form. This property is especially useful in event handlers, where you might need to refer to another element on the current form. ExamplesExample 1. In the following example, the form myForm contains a Hidden object and a button. When the user clicks the button, the value of the Hidden object is set to the form's name. The button's onClick event handler uses this.form to refer to the parent form, myForm .<FORM NAME="myForm"> Form name:<INPUT TYPE="hidden" NAME="h1" VALUE="Beluga"> <P> <INPUT NAME="button1" TYPE="button" VALUE="Store Form Name" onClick="this.form.h1.value=this.form.name"> </FORM> Example 2. The following example uses an object reference, rather than the this keyword, to refer to a form. The code returns a reference to myForm , which is a form containing myHiddenObject .document.myForm.myHiddenObject.form See alsoForm nameA string specifying the name of this object.
Method of | Hidden | Implemented in | Navigator 2.0 |
SecurityNavigator 3.0: This property is tainted by default. For information on data tainting, see "JavaScript Security".typeFor all Hidden objects, the value of the type property is "hidden" . This property specifies the form element's type.
Method of | Hidden | Read-only | | Implemented in | Navigator 3.0 |
ExamplesThe following example writes the value of the type property for every element on a form.for (var i = 0; i < document.myForm.elements.length; i++) { document.writeln("<BR>type is " + document.myForm.elements[i].type) } valueA string that reflects the VALUE attribute of the object.
Method of | Hidden | Implemented in | Navigator 2.0 |
SecurityNavigator 3.0: This property is tainted by default. For information on data tainting, see "JavaScript Security". ExamplesThe following function evaluates the value property of a group of buttons and displays it in the msgWindow window:function valueGetter() { var msgWindow=window.open("") msgWindow.document.write("The submit button says " + document.valueTest.submitButton.value + "<BR>") msgWindow.document.write("The reset button says " + document.valueTest.resetButton.value + "<BR>") msgWindow.document.write("The hidden field says " + document.valueTest.hiddenField.value + "<BR>") msgWindow.document.close() } This example displays the following values:The submit button says Query Submit The reset button says Reset The hidden field says pipefish are cute. The previous example assumes the buttons have been defined as follows:<INPUT TYPE="submit" NAME="submitButton"> <INPUT TYPE="reset" NAME="resetButton"> <INPUT TYPE="hidden" NAME="hiddenField" VALUE="pipefish are cute."> |
| |
|