Control Element

This section describes the various WebDDA binding’s elements.

<AnchorElement> associates a named control to an <a/> HTML element.


                    <AnchorElement name="control name">
   Search Path Elements
</AnchorElement>

                  

Element

Description

FindControl

Returns “true” or “false” whether control can be found on UI

GetControlValue

Returns URL text.

SetControlValue

Throws UnsupportedControlOperation exception

ExecuteControlAction

Navigates to the specified URL.


<ButtonElement> associates a named control to an <button/> HTML element.



                    <ButtonElement name="control name">
   Search Path Elements
</ButtonElement>

                  

Element

Description

FindControl

Returns “true” or “false” whether control can be found on UI

GetControlValue

Returns URL text.

SetControlValue

Throws UnsupportedControlOperation exception

ExecuteControlAction

Executes a click() command on the control


<InputElement> associates a named control with an <input/> HTML element if the element has one of the following type=attribute values: check box, radio, text, password, submit, reset, hidden, image, or file.



                    <InputElement name="control name" type="type">
   Search Path Elements
</InputElement>

                  

Element

Description

FindControl

Returns “true” if it finds the element on the page or “false” if it does not find the element.

GetControlValue

Returns “true” or “false” (string-valued) when type=”checkbox” or “radio”. Returns the value of the element for all other types.

SetControlValue

Sets to “true” or “false” when type=”checkbox” or “radio”. Sets the value of the element when type=”text” or “password” or “hidden”. Throws UnsupportedControlOperation exception for all other types.

ExecuteControlAction

Inverts an existing “true”/”false” state when type=”checkbox”. Sets state to “true” when type=”radio”. Returns UnsupportedControlOperation when type=”text” or “password” or “hidden”. Issues a Click() for all other types.


<SelectElement> searches for a named control on an HTML page, and returns or reverses its value.



                    <SelectElement name=" control name">
   Search Path Elements
</SelectElement>

                  

Element

Description

FindControl

Returns “true” or “false” whether control can be found in the UI

GetControlValue

Returns the selected item(s), as a comma-separated list

SetControlValue

Inverts the selection status of the first matching item in the list. This clears the entire selection when the provided set text is empty.

ExecuteControlAction

For single-selection modes, this inverts the selection status of the current selection. For multi-selection modes, it adds the next unselected item to the current selection


<TextAreaElement> associates a named control with a text area element on the HTML page.


                    <TextAreaElement name="name goes here">
   Search Path Elements
</TextAreaElement>

                  

Element

Description

FindControl

Returns “true” or “false” whether control can be found in the UI

GetControlValue

Returns the value of the text area element

SetControlValue

Sets the value of a text area element

ExecuteControlAction

Throws UnsupportedControlOperation exception.


<HTMLElement> associates a named control to the HTML object specified by the search path.



                    <ButtonElement name="control name">
   Search Path Elements
</ButtonElement>

                  

Element

Description

FindControl

Returns “true” or “false” whether control can be found in the UI

GetControlValue

Returns the content of the HTML object.

SetControlValue

Throws UnsupportedControlOperation exception

ExecuteControlAction

Executes a click() command on the control


The HyperLink element does not define an element on the Web applications UI but allows navigating to a specified URL. In difference to the other element types defined below, this element does not allow to navigate through the DOM tree (e.g. using <ElementMatchPath/>), it only takes the <Url> tag to specify the target URL.



                    <HyperLink name="control name">
   <Url>http://www.urlgoeshere.org</Url>
</HyperLink>

                  

Element

Description

FindControl

Returns whether control can be found in the bindings. Keep in mind the control does not exist on the UI just in the bindings.

GetControlValue

Returns URL text.

SetControlValue

Set the value of the control to the specified URL.

ExecuteControlAction

Navigates to the specified URL.


Show: