Documentation Index
Fetch the complete documentation index at: https://mintlify.com/parttio/dramafinder/llms.txt
Use this file to discover all available pages before exploring further.
Overview
HasEnabledElement provides methods for checking and asserting the enabled/disabled state of Vaadin components. This interface is essential for testing interactive components that can be enabled or disabled based on application logic.
Interface Location: org.vaadin.addons.dramafinder.element.shared.HasEnabledElement
Methods
getEnabledLocator()
default Locator getEnabledLocator()
Locator - The locator to check for enabled/disabled state
isEnabled()
default boolean isEnabled()
boolean - true if the component is enabled, false if disabled
assertEnabled()
default void assertEnabled()
AssertionError if the component is disabled
assertDisabled()
default void assertDisabled()
AssertionError if the component is enabled
Implementing Classes
The following element classes implement HasEnabledElement:
ButtonElementCheckboxElementRadioButtonElementRadioButtonGroupElementMessageInputElementGridElementUploadElementSideNavigationItemElement- All text field components (via
TextFieldElement and its subclasses)
Usage Example
import org.vaadin.addons.dramafinder.element.ButtonElement;
import org.vaadin.addons.dramafinder.element.TextFieldElement;
import com.microsoft.playwright.Page;
public class EnabledStateTest {
void testEnabledState(Page page) {
ButtonElement submitButton = ButtonElement.getByText(page, "Submit");
TextFieldElement nameField = TextFieldElement.getByLabel(page, "Name");
// Check initial state
submitButton.assertDisabled();
nameField.assertEnabled();
// Enable button after filling field
nameField.setValue("John Doe");
submitButton.assertEnabled();
// Verify button can be clicked when enabled
if (submitButton.isEnabled()) {
submitButton.click();
}
}
}
Implementation Details
Locator Delegation Pattern
Some components override getEnabledLocator() to target a specific internal element rather than the component root. For example, text field components delegate to their input element:
@Override
public Locator getEnabledLocator() {
return getInputLocator(); // Check disabled state on input, not wrapper
}
Playwright’s isEnabled()
The isEnabled() method uses Playwright’s built-in Locator.isEnabled(), which checks whether an element:
- Does not have the
disabled attribute
- Is not a disabled fieldset ancestor
- Is not hidden or detached from the DOM
Testing Patterns
// Button starts disabled
ButtonElement save = ButtonElement.getByText(page, "Save");
save.assertDisabled();
// Fill required fields to enable button
TextFieldElement name = TextFieldElement.getByLabel(page, "Name");
TextFieldElement email = TextFieldElement.getByLabel(page, "Email");
name.setValue("John");
email.setValue("john@example.com");
// Button should now be enabled
save.assertEnabled();
save.click();
// Test read-only mode
CheckboxElement readOnlyToggle = CheckboxElement.getByLabel(page, "Read-only mode");
readOnlyToggle.setChecked(true);
TextFieldElement field = TextFieldElement.getByLabel(page, "Description");
field.assertDisabled();
Dynamic State Changes
// Test that component state changes dynamically
ButtonElement action = ButtonElement.getByText(page, "Process");
action.assertEnabled();
action.click();
// Button disabled during processing
action.assertDisabled();
// Wait for processing to complete
page.waitForTimeout(2000);
action.assertEnabled();