org.testatoo.cartridge.html4.element

Class Select

java.lang.Object

org.testatoo.core.component.Component

org.testatoo.core.component.ListModel

org.testatoo.cartridge.html4.element.Select

All Implemented Interfaces:

Coreattrs, I18n, org.testatoo.core.nature.LabelSupport, org.testatoo.core.nature.MultiSelectable

public final class Select
extends org.testatoo.core.component.ListModel
implements org.testatoo.core.nature.MultiSelectable, org.testatoo.core.nature.LabelSupport, Coreattrs, I18n

This class allows the testing of the "select" element properties for html4. Select is a drop-down list ; each list item of a select is an option element.

Author:

dev@testatoo.org

See Also:

"select" specification

Constructor Summary

Constructors

Constructor and Description
Select(HtmlEvaluator evaluator, String id) Class constructor specifying the evaluator to use and the id of the "select" element we want to test.

Method Summary

Methods

Modifier and Type	Method and Description
String	classname() To get the class attribute of an html element
Direction	direction() To get the direction attribute of the html element
boolean	isMultiple() To know if a list is multi-selectable.
String	label() To get the "label" corresponding to the "select" element the label of the select is the content of the "label" element with a "for" attribute equals to the select id
String	language() To get the language attribute of the html element
protected org.testatoo.core.Selection<String>	listSelectedValues() To get the selected values in the list.
String	name() To get the name attribute of the list.
org.testatoo.core.Selection<OptionGroup>	optionGroups() To get the optiongroups in the list.
org.testatoo.core.Selection<Option>	options() To get the options in the list.
void	select(String value) To select in the list an item with a given value.
org.testatoo.core.Selection<Option>	selectedOptions() To get the selected options in the list.
org.testatoo.core.Selection<String>	selectedValues() To get the selected values in the list.
int	size() To get the size attribute of the list.
String	style() To get the style attribute of an html element
int	tabindex() To get the tabindex attribute of the list.
String	title() To get the title attribute of an html element
String	toString() To get the string describing the list.
void	unselect(String value) To unselect in the list an item with a given value.
void	unselectAll() To unselect all the selected values of the list.
org.testatoo.core.Selection<String>	values() To get the values in the list.
int	visibleRows() To get the number of visible items of the list.

Methods inherited from class org.testatoo.core.component.ListModel

unSelect

Methods inherited from class org.testatoo.core.component.Component

checkIsExpectedComponent, equals, hasFocus, hashCode, id, isDisabled, isEnabled, isVisible

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.testatoo.cartridge.html4.element.Coreattrs

id

Constructor Detail

Select

public Select(HtmlEvaluator evaluator,
      String id)

Class constructor specifying the evaluator to use and the id of the "select" element we want to test.

Parameters:

evaluator - a UI Test engine specific html evaluator

id - the id (unique) of the "select" element

Method Detail

label

public String label()

To get the "label" corresponding to the "select" element the label of the select is the content of the "label" element with a "for" attribute equals to the select id

Specified by:

label in interface org.testatoo.core.nature.LabelSupport

Returns:

the content of label attribute corresponding to the "select" element

classname

public String classname()

Description copied from interface: Coreattrs

To get the class attribute of an html element

Specified by:

classname in interface Coreattrs

Returns:

the class attribute of the html element.

See Also:

CoreAttributeSupport

style

public String style()

Description copied from interface: Coreattrs

To get the style attribute of an html element

Specified by:

style in interface Coreattrs

Returns:

the style attribute of the html element.

See Also:

CoreAttributeSupport

title

public String title()

Description copied from interface: Coreattrs

To get the title attribute of an html element

Specified by:

title in interface Coreattrs

Returns:

the title attribute of the html element.

See Also:

CoreAttributeSupport

language

public String language()

Description copied from interface: I18n

To get the language attribute of the html element

Specified by:

language in interface I18n

Returns:

the language attribute of the html element

See Also:

I18nAttributeSupport

direction

public Direction direction()

Description copied from interface: I18n

To get the direction attribute of the html element

Specified by:

direction in interface I18n

Returns:

the direction attribute of the html element

See Also:

I18nAttributeSupport

selectedValues

public org.testatoo.core.Selection<String> selectedValues()

To get the selected values in the list.

Specified by:

selectedValues in interface org.testatoo.core.nature.MultiSelectable

Returns:

a list of String

See Also:

listSelectedValues()

listSelectedValues

protected org.testatoo.core.Selection<String> listSelectedValues()

To get the selected values in the list.

Overrides:

listSelectedValues in class org.testatoo.core.component.ListModel

Returns:

a list of String

See Also:

selectedValues()

select

public void select(String value)

To select in the list an item with a given value. If the item has no value, the item with the content equals to the value is selected

Overrides:

select in class org.testatoo.core.component.ListModel

Parameters:

value - the value of the item we want to select

unselect

public void unselect(String value)

To unselect in the list an item with a given value. If the item has no value, the item with the content equals to the value is deselected

Parameters:

value - the value of the item we want to unselect

values

public org.testatoo.core.Selection<String> values()

To get the values in the list.

Overrides:

values in class org.testatoo.core.component.ListModel

Returns:

a list of String

unselectAll

public void unselectAll()

To unselect all the selected values of the list.

isMultiple

public boolean isMultiple()

To know if a list is multi-selectable.

Returns:

true if the list is multi-selectable

options

public org.testatoo.core.Selection<Option> options()

To get the options in the list.

Returns:

a list of options

optionGroups

public org.testatoo.core.Selection<OptionGroup> optionGroups()

To get the optiongroups in the list.

Returns:

a list of optionGroups

selectedOptions

public org.testatoo.core.Selection<Option> selectedOptions()

To get the selected options in the list.

Returns:

a list of options

visibleRows

public int visibleRows()

To get the number of visible items of the list.

Returns:

the number of visible rows

name

public String name()

To get the name attribute of the list. name can be used so that the value of the selected option element can be processed.

Returns:

the name of the list

See Also:

W3C recommendation

tabindex

public int tabindex()

To get the tabindex attribute of the list. Tabindex can be used to specify where the element appears in the tab order of the page.

Returns:

the tabindex of the list

See Also:

W3C recommendation

size

public int size()

To get the size attribute of the list. Size corresponds to the number of visible rows.

Returns:

the size of the list

See Also:

visibleRows()

toString

public String toString()

To get the string describing the list.

Overrides:

toString in class org.testatoo.core.component.ListModel

Returns:

string describing the list and its content