new¶

Creates a new ActionChains object. Requires a Selenium::Remote::Driver as a mandatory parameter:

    my $driver = Selenium::Remote::Driver->new;
    my $action_chains = Selenium::ActionChains->new(driver => $driver);

perform¶

Performs all the actions stored in the ActionChains object in the order they were called:

    Args: None
    Usage:
        my $action_chains = Selenium::ActionChains->new(driver => $driver);
        # assuming that $some_element and $other_element are valid
        # Selenium::Remote::WebElement objects
        $action_chains->click($some_element);
        $action_chains->move_to_element($other_element);
        $action_chains->click($other_element);
        # click some_element, move to other_element, then click other_element
        $action_chains->perform;

click¶

Clicks an element. If none specified, clicks on current mouse position.

    Args: A Selenium::Remote::WebElement object
    Usage:
        my $element = $driver->find_element("//div[\@id='some_id']");
        $action_chains->click($element);

click_and_hold¶

Holds down the left mouse button on an element. If none specified, clicks on current mouse position.

    Args: A Selenium::Remote::WebElement object
    Usage:
        my $element = $driver->find_element("//div[\@id='some_id']");
        $action_chains->click_and_hold($element);

context_click¶

Right clicks an element. If none specified, right clicks on current mouse position.

    Args: A Selenium::Remote::WebElement object
    Usage:
        my $element = $driver->find_element("//div[\@id='some_id']");
        $action_chains->context_click($element);

double_click¶

Double clicks an element. If none specified, double clicks on current mouse position.

    Args: A Selenium::Remote::WebElement object
    Usage:
        my $element = $driver->find_element("//div[\@id='some_id']");
        $action_chains->double_click($element);

drag_and_drop - NOT WORKING¶

Holds down the left mouse button on the source element, then moves to the target element and releases the mouse button. IT IS NOT WORKING DUE TO CURRENT SELENIUM LIMITATIONS.

    Args:
       A source Selenium::Remote::WebElement object
       A target Selenium::Remote::WebElement object
    Usage:
        my $src_element = $driver->find_element("//*[\@class='foo']");
        my $tgt_element = $driver->find_element("//*[\@class='bar']");
        $action_chains->drag_and_drop($src_element,$tgt_element);

drag_and_drop_by_offset - NOT WORKING¶

Holds down the left mouse button on the source element, then moves to the offset specified and releases the mouse button. IT IS NOT WORKING DUE TO CURRENT SELENIUM LIMITATIONS.

    Args:
       A source Selenium::Remote::WebElement object
       An integer X offset
       An integer Y offset
    Usage:
        my $src_element = $driver->find_element("//*[\@class='foo']");
        my $xoffset = 10;
        my $yoffset = 10;
        $action_chains->drag_and_drop($src_element,$xoffset,$yoffset);

key_down¶

Sends key presses only, without releasing them. Useful when modifier keys are requried

Will DWIM your input and accept either a string or ARRAYREF of keys.

    Args:
        An array ref to keys to send. Use the KEY constant from Selenium::Remote::WDKeys
        The element to send keys to. If none, sends keys to the current focused element
    Usage:
        use Selenium::Remote::WDKeys 'KEYS';
        # DEFINITELY cut and paste this in without looking
        $action_chains->key_down( [ KEYS->{'alt'}, KEYS->{'F4'} ] );

key_up¶

Releases prior key presses. Useful when modifier keys are requried

Will DWIM your input and accept either a string or ARRAYREF of keys.

    Args:
        An array ref to keys to send. Use the KEY constant from Selenium::Remote::WDKeys
        The element to send keys to. If none, sends keys to the current focused element
    Usage:
        use Selenium::Remote::WDKeys 'KEYS';
        # Fullscreen the foo element
        my $element = $driver->find_element('foo','id');
        $action_chains->key_down( [ KEYS->{'alt'}, KEYS->{'enter'} ], $element );
        $action_chains->key_up( [ KEYS->{'alt'}, KEYS->{'enter'} ],   $element);

move_by_offset¶

Moves the mouse to an offset from current mouse position.

    Args:
        An integer X offset
        An integer Y offset
    Usage:
        $action_chains->move_by_offset(10,100);

move_to_element¶

Moves the mouse to the middle of an element

    Args:
        A Selenium::Remote::WebElement to move to
    Usage:
        my $element = $driver->find_element('foo','id');
        $action_chains->move_to_element($element);

move_to_element_with_offset¶

Moves the mouse by an offset of the specified element. Offsets are relative to the top-left corner of the element

    Args:
        A Selenium::Remote::WebElement
        An integer X offset
        An integer Y offset
    Usage:
        my $element = $driver->find_element('foo','id');
        $action_chains->move_to_element_with_offset($element,10,10);

release¶

Releases a held mouse_button

    Args:
        A Selenium::Remote::WebElement, the element to mouse up
    Usage:
        my $element = $driver->find_element('foo','id');
        $action_chains->release($element);

send_keys¶

Sends keys to the currently focused element. Essentially an alias around key_down then key_up.

Will DWIM your input and accept either a string or ARRAYREF of keys.

    Args:
        The keys to send
    Usage:
        $action_chains->send_keys('abcd');

send_keys_to_element¶

Sends keys to an element in much the same fashion as send_keys.

Will DWIM your input and accept either a string or ARRAYREF of keys.

    Args:
        A Selenium::Remote::WebElement
        The keys to send
    Usage:
        my $element = $driver->find_element('foo','id');
        $action_chains->send_keys_to_element($element,'abcd');