NAME

       Weasel::Element - The base HTML/Widget element class

VERSION

       0.01

SYNOPSIS

          my $element = $session->page->find("./input[\@name='phone']");
          my $value = $element->send_keys('555-885-321');

DESCRIPTION

       This module provides the base class for all page elements, encapsulating the regular
       element interactions, such as finding child element, querying attributes and the tag name,
       etc.

ATTRIBUTES

       session
           Required.  Holds a reference to the Weasel::Session to which the element belongs.
           Used to access the session's driver to query element properties.x

       _id Required.  Holds the element_id used by the session's driver to identify the element.

METHODS

       find($locator [, scheme => $scheme] [, %locator_args])
           Finds the first child element matching c<$locator>.  Returns "undef" when not found.
           Optionally takes a scheme argument to identify non-xpath type locators.

           In case the $locator is a mnemonic (starts with an asterisk ['*']), additional
           arguments may be provided for expansion of the mnemonic.  See
           Weasel::FindExpanders::HTML for documentation of the standard expanders.

       find_all($locator [, scheme => $scheme] [, %locator_args])
           Returns, depending on scalar vs array context, a list or an arrayref with matching
           elements.  Returns an empty list or ref to an empty array when none found.  Optionally
           takes a scheme argument to identify non-xpath type locators.

           In case the $locator is a mnemonic (starts with an asterisk ['*']), additional
           arguments may be provided for expansion of the mnemonic.  See
           Weasel::FindExpanders::HTML for documentation of the standard expanders.

       get_attribute($attribute)
           Returns the value of the element's attribute named in $attribute or "undef" if none
           exists.

           Note: Some browsers apply default values to attributes which are not
             part of the original page.  As such, there's no direct relation between
             the existence of attributes in the original page and this function
             returning "undef".

       get_text()
           Returns the element's 'innerHTML'.

       has_class
       is_displayed
           Returns a boolean indicating if an element is visible (e.g.  can potentially be
           scrolled into the viewport for interaction).

       click()
           Scrolls the element into the viewport and simulates it being clicked on.

       send_keys(@keys)
           Focusses the element and simulates keyboard input. @keys can be any number of strings
           containing unicode characters to be sent.  E.g.

              $element->send_keys("hello", ' ', "world");

       tag_name()
           Returns the name of the tag of the element, e.g. 'div' or 'input'.