Package allurium.tabs

Class AbstractTabs

java.lang.Object

allurium.primitives.UIElement

allurium.AbstractWidget

allurium.tabs.AbstractTabs

All Implemented Interfaces:

AlluriumElement, ListComponent, WebElementMeta

public abstract class AbstractTabs
extends AbstractWidget

Represents an abstract base class for tab components in a UI.

This class provides a foundation for handling tab-based navigation, allowing subclasses to define specific behaviors such as retrieving the currently active tab.

Features:

• Encapsulates tab selection logic.
• Supports multiple initialization methods using different locators.
• Provides an abstract contract for retrieving the active tab.
• Extends AbstractWidget to inherit UI component functionality.

Usage Example:

 public class NavigationTabs extends AbstractTabs {

     public NavigationTabs(String selector) {
         super(selector);
     }

     @Override
     public String getActiveTabName() {
         return tabs.filter(Condition.cssClass("active")).first().text();
     }

     @Override
     public Tab getActive() {
         return new Tab(tabs.filter(Condition.cssClass("active")).first());
     }
 }

 // Selecting a tab
 NavigationTabs tabs = new NavigationTabs(".nav-tabs > li");
 tabs.select("Settings");
 

Constructors:

• AbstractTabs() - Default constructor.
• AbstractTabs(String) - Initializes the tabs using a Selenide selector string.
• AbstractTabs(By) - Initializes the tabs using a Selenium By locator.

See Also:

• AbstractWidget
• ElementType

Field Summary

Fields inherited from class allurium.primitives.UIElement

assignNameMethod, description, id, parent, root, stepsConsoleLoggingEnabled, stepsReportLoggingEnabled, uiElementName, uiElementType

Constructor Summary

Constructors

Constructor	Description
AbstractTabs()	Default constructor.
AbstractTabs(String selenideLocator)	Constructs an AbstractTabs instance using a Selenide selector string.
AbstractTabs(org.openqa.selenium.By locator)	Constructs an AbstractTabs instance using a Selenium By locator.

Method Summary

Modifier and Type	Method	Description
abstract Tab	getActive()	Retrieves the currently active tab as a Tab object.
abstract String	getActiveTabName()	Retrieves the name of the currently active tab.
void	select(String tabName)	Selects a tab by its displayed name.

Methods inherited from class allurium.AbstractWidget

getHeight, getRoot, getWidth, setRoot

Methods inherited from class allurium.primitives.UIElement

_$uiElement, $uiElement, $uiElement, $uiElement, $uiElement, $uiElement, $uiElement, applyName, applyName, as, assertEmpty, assertEquals, assertExists, assertExists, assertHasCssClass, assertHasCssClass, assertHasNotCssClass, assertHasNotCssClass, assertHasNotCssClass, assertHasText, assertIsNotEmpty, assertNotExist, assertNotExist, assertNotVisible, assertNotVisible, assertNotVisible, assertText, assertVisible, assertVisible, assertVisible, assertVisible, assertVisibleInViewport, click, click, click, click, click, clickAndHold, clickAndHold, clickAndHold, contextClick, contextClick, contextClick, doubleClick, doubleClick, doubleClick, get, getAllureCompiledStep, getAttribute, getId, getStepText, getUiElementName, hover, hover, hover, isDisplayed, logStep, logStepToReport, logStepToReport, scrollTo, scrollTo, scrollTo, setRoot, text, verifyEmpty, verifyIsNotEmpty, wrappedName

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface allurium.interfaces.WebElementMeta

getDescription, getMetaKeys, getParent, setAssignNameMethod, setDescription, setParent, setUiElementName

Constructor Details

AbstractTabs

public AbstractTabs()

Default constructor. Initializes the tab component as a generic UI element with type "tabs".

AbstractTabs

public AbstractTabs(String selenideLocator)

Constructs an AbstractTabs instance using a Selenide selector string.

The provided selector is used to locate all tab elements.

Parameters:

selenideLocator - the Selenide selector string for locating tab elements

AbstractTabs

public AbstractTabs(org.openqa.selenium.By locator)

Constructs an AbstractTabs instance using a Selenium By locator.

The provided locator is used to find the tab elements.

Parameters:

locator - the Selenium By locator for finding tab elements

Method Details

select

public void select(String tabName)

Selects a tab by its displayed name.

The method searches for a tab element that exactly matches the provided tabName and clicks on it to activate the tab.

Behavior:

• Filters the tab elements based on exact text match.
• Clicks the first matching tab.

Usage Example:

 AbstractTabs tabs = new NavigationTabs(".tab-items");
 tabs.select("Dashboard");
 

Parameters:

tabName - the exact text of the tab to be selected

getActiveTabName

public abstract String getActiveTabName()

Retrieves the name of the currently active tab.

Subclasses must implement this method to define the logic for identifying the active tab.

Returns:

the name of the active tab

getActive

public abstract Tab getActive()

Retrieves the currently active tab as a Tab object.

Subclasses must implement this method to define how the active tab is identified and wrapped in a Tab instance.

Usage Example:

 Tab activeTab = myTabs.getActive();
 System.out.println("Currently active tab: " + activeTab.text());
 

Returns:

a Tab instance representing the currently active tab