Skip to content

AppianTab

AppianTab represents an Appian linked-card tab. Create it from AppianPage with page.tab(...).

details = page.tab(name="Details")

assert details.is_selected()

page.tab(name="Contacts").select()

Select and check a tab

select() selects the requested tab. If it is already selected, no additional action is performed.

Use is_selected() when the business flow needs to verify the active tab:

page.tab(name="Contacts").select()
assert page.tab(name="Contacts").is_selected()

AppianTab

Represent an Appian linked-card tab identified by its visible name.

Appian renders these tabs as role="link" containers. The same container includes accessibility-only state text:

  • Selected Tab. for the active tab;
  • Unselected Tab. Press enter to select tab. for an inactive tab.

The component intentionally uses those semantic role/text relationships instead of generated Appian CSS classes.

is_visible 

is_visible() -> bool

Return whether this tab is currently visible.

is_selected 

is_selected(timeout: float | None = None) -> bool

Return the tab's current selected state.

timeout is used only to wait for the tab itself to become visible. Once the tab exists, the method returns its current state immediately; it does not wait for an unselected tab to become selected.

select 

select() -> 'AppianTab'

Idempotently select this tab and wait for Appian to expose it as selected.

Exact matching and visibility

By default, robo-appian uses a visible component whose displayed name or label exactly matches what you provide. Keep exact=True and visible=True for normal business automation. Use exact=False only when you intentionally want a partial name or label match. Change visible only when your scenario specifically requires a component that is not currently visible.

Timeout

Component timeout values are expressed in seconds. timeout=None uses the configured default timeout; a positive finite value overrides that timeout for waits/actions performed by the component.