io.devcon5.pageobjects

Interface ElementGroup

All Known Subinterfaces:

Page

public interface ElementGroup

An element group is the base class for the entire page object model. Everything - starting from a page - is an element group. Using this interface Java Beans may be defined to define a set of elements that denote the. Groups may be extended and nested. It is a basic

Method Summary

Modifier and Type	Method and Description
default <T extends ElementGroup> T	get(Class<T> groupType, Class<? extends Annotation>... qualifiers) Retrieves a nested ElementGroup from this group by type.
default org.openqa.selenium.SearchContext	getSearchContext() Returns the search context for locating elements inside the element group.
default void	locateElements() Locates all elements specified either by field annotation or method annotation and injects the web element suppliers to each element.

Method Detail

getSearchContext

default org.openqa.selenium.SearchContext getSearchContext()

Returns the search context for locating elements inside the element group. If this method is not implemented, the default search context is the current webdriver.

Returns:

the search context for the element group.

get

default <T extends ElementGroup> T get(Class<T> groupType,
                                       Class<? extends Annotation>... qualifiers)

Retrieves a nested ElementGroup from this group by type. The method assumes there is only one ElementGroup of a specific type.

Type Parameters:

T - the type of the ElementGroup that should be retrieved

Parameters:

groupType - the type of the element group to retrieve

Returns:

the element group matching the specified type or an empty optional if no field of the specified type exists on the group.

locateElements

default void locateElements()

Locates all elements specified either by field annotation or method annotation and injects the web element suppliers to each element. To properly inject WebElement Suppliers, the fields must be of type Supplier<WebElement> and must be annotated with Locator. Same applies for setter methods, which must have a return type of void and must accept a single parameter being of type Supplier<WebElement>