JavaScripTools Manual

JavaScriptUtil

Retrieving and setting values on form fields and html elements

The getValue and setValue functions are used to retrieve and set values on both form fields or html elements (using the innerHTML property). The behaviour depends on the object type:

• text, password and textarea: The value is directly returned / set
• checkbox: Return the value of the checked controls (if more than one, the result will be an array) or set one or more of the controls, according to it's value (the setValue second argument may be an array).
• radio: Return the value of the checked control or set one of the controls, according to it's value.
• select: Return the value of the selected options (if more than one, the result will be an array) or select the option(s), according to the newValue parameter of the setValue function.

//Assume a div named dv, a text named txt and a set of checkboxes named chk, whith values "1", "2" and "3"
setValue("txt", "ABC") -> Sets the input value
getValue("txt") -> "ABC"
setValue("dv", "The new value") -> Sets the div innerHTML property
setValue("chk", ["1", "2"]) -> checks the checkboxes with value = 1 and 2

There is also the checkAll function, that checks or unchecks all checkboxes with a given name.

//Assume a set of checkboxes named chk
checkAll("chk") -> Check all
checkAll("chk", false) -> Uncheck all