ButtonElement
Playwright element wrapper for <vaadin-button> providing lookup helpers and interaction methods.
Component Tag
vaadin-button
Implements
FocusableElement - Focus managementHasAriaLabelElement - ARIA label supportHasEnabledElement - Enable/disable stateHasPrefixElement - Prefix slot contentHasStyleElement - CSS class and style managementHasSuffixElement - Suffix slot contentHasThemeElement - Theme variant supportHasTooltipElement - Tooltip text
Constructor
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)
Button’s accessible name or text content
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 buttonfocus() - Focus the buttonassertEnabled() - Assert button is enabledassertDisabled() - Assert button is disabledassertAriaLabel(String) - Assert ARIA labelgetPrefixLocator() - Get prefix slot locatorgetSuffixLocator() - Get suffix slot locatorassertTheme(String) - Assert theme variantassertTooltipHasText(String) - Assert tooltip text
Usage Examples
// 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();