DOM Traversal Methods

Parameters (First Version)
•
successful (optional): Whether to prune the included field values to
successful ones. The default value is true.
Parameters (Second Version)
•
•
element: The form input element whose value is to be retrieved.
successful (optional): Whether to prune the included field values to
successful ones. The default value is true.
Return Value
An array of strings containing the field values.
[ 227 ]
Chapter 11
Discussion
The .fieldValue() method and the $.fieldValue() function both fetch the values
of a form, returning them as an array of strings. The .fieldValue() method acts on
a jQuery object that references individual fields, while the $.fieldValue() function
performs the same task on the field element passed as its first parameter.
These operations can handle fields of any standard type, such as menus:
none
1-5
6-10
11-20
21-50
51-100
over 100
The user can then select any option:
The value is pulled from the currently selected option, and the .fieldValue()
method will return an array representation of this value:
[50]
Each of the given fields shows up as a string in the array. Checkbox elements that are
not checked do not get represented in the array.