Button Field
Button fields are used to interact with clickable elements on web pages, such as submit buttons, navigation buttons, or any clickable interface elements. They provide various configuration options for optimal button interaction behavior.
Basic Configuration
Field Properties
| Property | Description | Example |
|---|---|---|
| Field Name | Unique identifier for the field | submitButton, nextButton, save |
| Field Type | Set to Button for clickable elements | Button |
| Field Selector Type | Method to locate the field element | Selector, Id, XPath |
| Field Selector Query | Unique address to locate the field | #submit, button[type="submit"] |
| Field Value | Data source for button interaction | Excel column or default value |
Button Field Settings
🖱️ Button Click Behavior
Configure how the button interacts based on Excel data values.
Core Behavior:
- Excel Value Priority - Button behavior depends on Excel column value
- Conditional Clicking - Button only clicks when Excel value is not "not-click"
- Skip Behavior - Button is skipped when Excel value is "not-click"
Configuration:
- Toggle Switch: Enable/disable conditional button clicking
- Excel Value Check: System checks Excel column for "not-click" value
- Click Action: Button clicks only when Excel value is not "not-click"
Example Scenarios:
Excel Column Value: "click" → Button gets clicked
Excel Column Value: "not-click" → Button is skipped
Excel Column Value: "" (empty) → Button gets clicked
Excel Column Value: "submit" → Button gets clicked⏳ Element Detection Settings
Configure how the extension waits for and interacts with button elements.
Wait until element is found in the page
- Purpose: Ensures button exists in DOM before interaction
- Use Case: Dynamic content, AJAX-loaded buttons
- Configuration: Toggle ON/OFF
Wait until element is visible in the page
- Purpose: Ensures button is both found and visible
- Use Case: Hidden buttons, CSS visibility controls
- Configuration: Toggle ON/OFF
⚡ Trigger Javascript Event
Configure JavaScript events to be triggered on the button element.
Supported Events:
- click - Triggers when button is clicked
- focus - Triggers when button receives focus
- blur - Triggers when button loses focus
- mousedown - Triggers on mouse press
- mouseup - Triggers on mouse release
- mouseover - Triggers when mouse hovers over button
Configuration:
- Toggle Switch: Enable JavaScript event triggering
- Event Selection: Choose specific events to trigger
- Multiple Events: Can select multiple events simultaneously
Button Interaction Types
Standard Click
- Behavior: Single click action
- Use Case: Submit buttons, navigation buttons
- Configuration: Default button behavior
Skip Button
- Behavior: Button is ignored when Excel value is "not-click"
- Use Case: Optional form steps, conditional workflows
- Configuration: Excel value "not-click" skips button
Troubleshooting
Button Not Clicking
- Check selector accuracy
- Verify element visibility
- Test with different selectors
- Check Excel value format
Next Steps
- Field Types - Learn about different field types
- Field Response Actions - Configure response behaviors
- Variables - Use variables in field settings
- Site Settings - Configure site-wide settings