Select UI Elements

from askui import Agent, locators as loc

with VisionAgent() as agent:
    agent.tools.webbrowser.open_new("https://docs.askui.com")
    agent.wait(3)  # Wait for page to load

    # Click using natural language
    agent.click("Login button")

from askui import Agent, locators as loc

with VisionAgent() as agent:
    agent.tools.webbrowser.open_new("https://docs.askui.com")
    agent.wait(3)  # Wait for page to load
   
    agent.click(loc.Element("textfield"))
    agent.type("Hello")

# Click the textfield to the right of "Username"
agent.click(
    loc.Element().right_of(loc.Text("Username"))
)

# Select button below specific text
agent.click(
    loc.Element().below_of(loc.Text("Terms and Conditions"))
)

# Find element nearest to another
agent.click(
    loc.Text("Edit").nearest_to(loc.Text("Profile Settings"))
)

# Select the first matching element
agent.click(loc.Text("Delete").first())

# Select by index (0-based)
agent.click(loc.Element("button").at_index(2))

# Select within a specific area
agent.click(
    loc.Text("Submit").inside_of(loc.Element("form"))
)

# Set display before interactions (1-based)
agent.tools.os.set_display(2)  # Use second display
agent.click("Submit")

# Or with locators
agent.tools.os.set_display(1)  # Use primary display
agent.click(loc.Text("Submit"))