new SelectElement(dom_element, control_info)
Creates a SelectElement object used to hold information about select elements
Parameters:
Name | Type | Description |
---|---|---|
dom_element |
DOMelement | The dom element object representing the select element |
control_info |
ControlInfo | Information about the parent controls |
- Source:
- scripts/cache_controls.js, line 2992
Properties:
Name | Type | Description |
---|---|---|
dom_element |
DOMElement | Reference to the dom element representing the select element |
cache_id |
String | String that uniquely identifies the cache element object in the cache |
document_order |
Number | Ordinal position of the control element in the document in relationship to other control elements |
name_attribute |
String | Value of the name attribute |
type |
String | String indicating the type of form control |
child_cache_elements |
Array | Array of child cache control elements as part of cache control tree |
option_elements |
Array | Array of child cache option elements |
control_type |
Number | Constant indicating the type of cache control object |
label_element |
LabelElement | Reference to any label element that this input is nested in |
fieldset_element |
FieldsetElement | Reference to any fieldset elements this select element is nested in |
computed_label |
String | Calculated label for the select element |
computed_label_length |
Number | Length of the label property |
computed_label_for_comparison |
String | Label for comparison (lowercase, space normalization and trimmed) |
size |
String | The value of the size attribute |
multiple |
String | The value of the multiple attribute |
is_owned |
Boolean | True if this control is owned by another widget |
owner_controls |
Array | Array of all the widgets that own this widget (NOTE: More than one owner is an error) |
Methods
-
addOption(child_control)
-
add a OptionElement object reference to the tree of
Parameters:
Name Type Description child_control
Object control cache element object - Source:
- scripts/cache_controls.js, line 3085
Returns:
nothing -
<static> addChildControl(control_element)
-
Adds a cache control element to the tree representation of control elements
Parameters:
Name Type Description control_element
WidgetElement | ButtonElement | FieldsetElement | FormElement | InputElement | LabelElement | LegendElement | OptgroupElement | OptionElement | SelectElement | TextareaElement Cache control element object to add - Source:
- scripts/cache_controls.js, line 3057
-
<static> getAttributes(unsorted) → {Array}
-
Returns an array of attributes for the element, sorted in alphabetical order
Parameters:
Name Type Description unsorted
Boolean If defined and true the results will NOT be sorted alphabetically - Source:
- scripts/cache_controls.js, line 3125
Returns:
Returns a array of attribute display object- Type
- Array
-
<static> getCacheProperties(unsorted) → {Array}
-
Returns an array of cache properties sorted by property name
Parameters:
Name Type Description unsorted
Boolean If defined and true the results will NOT be sorted alphabetically - Source:
- scripts/cache_controls.js, line 3149
Returns:
Returns a array of cache property display object- Type
- Array
-
<static> getCachePropertyValue(property) → {String|Number}
-
Returns the value of a property
Parameters:
Name Type Description property
String The property to retreive the value - Source:
- scripts/cache_controls.js, line 3176
Returns:
Returns the value of the property- Type
- String | Number
-
<static> getEvents() → {Array}
-
Returns an array of events for the element, sorted in alphabetical order
- Source:
- scripts/cache_controls.js, line 3198
Returns:
Returns a array of event item display objects- Type
- Array
-
<static> getLabelNLS() → {String|Object}
-
Returns an object with an NLS localized string and style properties If label is empty a missing label message will the returned
- Source:
- scripts/cache_controls.js, line 3214
Returns:
Returns a String if the label has content, but if label is empty it returns an object with a 'label and 'style' property- Type
- String | Object
-
<static> getLabelSourceNLS() → {String|Object}
-
Returns an object with an NLS localized information on the source of the label
- Source:
- scripts/cache_controls.js, line 3243
Returns:
Returns a String if the label has content, but if label is empty it returns an object with a 'label and 'style' property- Type
- String | Object
-
<static> getNodeResults() → {Array}
-
Returns an array of node results in severity order
- Source:
- scripts/cache_controls.js, line 3095
Returns:
Returns a array of node results- Type
- Array
-
<static> getStyle() → {Array}
-
Returns an array of style items
- Source:
- scripts/cache_controls.js, line 3109
Returns:
Returns a array of style display objects- Type
- Array
-
<static> toString() → {String}
-
Returns a text string representation of the select element
- Source:
- scripts/cache_controls.js, line 3283
Returns:
Returns string represention the SelectElement object- Type
- String