ButtonElement

Playwright element wrapper for Vaadin Button component

ButtonElement

Playwright element wrapper for <vaadin-button> providing lookup helpers and interaction methods.

Component Tag

vaadin-button

Implements

• FocusableElement - Focus management
• HasAriaLabelElement - ARIA label support
• HasEnabledElement - Enable/disable state
• HasPrefixElement - Prefix slot content
• HasStyleElement - CSS class and style management
• HasSuffixElement - Suffix slot content
• HasThemeElement - Theme variant support
• HasTooltipElement - Tooltip text

Constructor

locator · Locator · required

Playwright locator for the <vaadin-button> element

Static Factory Methods

getByText

Get a button by its accessible name or visible text.

ButtonElement.getByText(Page page, String text)
ButtonElement.getByText(Page page, Page.GetByRoleOptions options)
ButtonElement.getByText(Locator locator, String text)
ButtonElement.getByText(Locator locator, Locator.GetByRoleOptions options)

page · Page

Playwright page

locator · Locator

Scope to search within

text · String

Button’s accessible name or text content

options · GetByRoleOptions

Options for getByRole (ARIA BUTTON role)

getByLabel

Alias for getByText(Page, String).

ButtonElement.getByLabel(Page page, String text)

Methods

All methods from implemented mixin interfaces are available. See:

• click() - Click the button
• focus() - Focus the button
• assertEnabled() - Assert button is enabled
• assertDisabled() - Assert button is disabled
• assertAriaLabel(String) - Assert ARIA label
• getPrefixLocator() - Get prefix slot locator
• getSuffixLocator() - Get suffix slot locator
• assertTheme(String) - Assert theme variant
• assertTooltipHasText(String) - Assert tooltip text

Usage Examples

Basic Button Interaction

// Find and click a button
ButtonElement button = ButtonElement.getByText(page, "Click me");
button.assertEnabled();
button.click();

Check Theme and Style

ButtonElement button = ButtonElement.getByText(page, "Enabled Button");
button.assertTheme("success");
button.assertCssClass("custom-button");

Working with Disabled State

ButtonElement button = ButtonElement.getByText(page, "Toggle Button");
button.assertEnabled();
button.click();
button.assertDisabled();

Prefix and Suffix Content

ButtonElement iconButton = ButtonElement.getByText(page, "Icon Button");
assertThat(iconButton.getPrefixLocator()).hasText("Prefix");
assertThat(iconButton.getSuffixLocator()).hasText("Suffix");
iconButton.assertPrefixHasText("Prefix");
iconButton.assertSuffixHasText("Suffix");

Focus Management

ButtonElement button = ButtonElement.getByText(page, "Enabled Button");
button.assertIsFocused();

ButtonElement nextButton = ButtonElement.getByText(page, "Toggle Button");
nextButton.assertIsNotFocused();
nextButton.focus();
nextButton.assertIsFocused();

Scoped Lookup

// Find button within a specific container
CardElement card = CardElement.getByTitle(page, "Booking Card");
ButtonElement bookButton = ButtonElement.getByText(card.getLocator(), "Book now");
bookButton.click();