page-object 0.5.5 → 0.6

data/features/support/url_helper.rb

@@ -36,5 +36,9 @@ module UrlHelper
     def async
       "#{files}/async.html"
     end
+
+    def multi
+      "#{files}/multi_elements.html"
+    end
   end
 end

data/lib/page-object/accessors.rb

@@ -20,7 +20,7 @@ module PageObject
         platform.navigate_to url
       end
     end
-    
+
     #
     # Identify an element as existing within a frame or iframe.  A frame parameter
     # is passed to the block and must be passed to the other calls to PageObject.

data/lib/page-object/element_locators.rb

@@ -19,6 +19,25 @@ module PageObject
     def button_element(identifier)
       platform.button_for(identifier.clone)
     end
+
+    #
+    # Finds all buttons that match the provided identifier
+    #
+    # @param [Hash] identifier how we find a button.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :text => Watir only
+    #   * :value => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #   * :src => Watir and Selenium (image button only)
+    #   * :alt => Watir and Selenium (image button only)
+    #
+    def button_elements(identifier)
+      platform.buttons_for(identifier.clone)
+    end
     
     #
     # Finds a text field
@@ -40,6 +59,26 @@ module PageObject
       platform.text_field_for(identifier.clone)
     end
     
+    #
+    # Finds all text fields that match the provided identifier
+    #
+    # @param [Hash] identifier how we find a text field.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :css => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :tag_name => Watir and Selenium
+    #   * :text => Watir only
+    #   * :title => Watir and Selenium
+    #   * :value => Watir only
+    #   * :xpath => Watir and Selenium
+    #
+    def text_field_elements(identifier)
+      platform.text_fields_for(identifier.clone)
+    end
+    
     #
     # Finds a hidden field
     #
@@ -58,6 +97,24 @@ module PageObject
       platform.hidden_field_for(identifier.clone)
     end
     
+    #
+    # Finds all hidden fields that match the identifier
+    #
+    # @param [Hash] identifier how we find a hidden field.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :css => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :tag_name => Watir and Selenium
+    #   * :text => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #
+    def hidden_field_elements(identifier)
+      platform.hidden_fields_for(identifier.clone)
+    end
+    
     #
     # Finds a text area
     #
@@ -75,6 +132,23 @@ module PageObject
       platform.text_area_for(identifier.clone)
     end
     
+    #
+    # Finds all text areas for the provided identifier
+    #
+    # @param [Hash] identifier how we find a text area.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :css => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :tag_name => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #
+    def text_area_elements(identifier)
+      platform.text_areas_for(identifier.clone)
+    end
+    
     #
     # Finds a select list
     #
@@ -92,6 +166,23 @@ module PageObject
       platform.select_list_for(identifier.clone)
     end
     
+    #
+    # Finds all select lists for the provided identifier
+    #
+    # @param [Hash] identifier how we find a select list.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :text => Watir only
+    #   * :value => Watir only
+    #   * :xpath => Watir and Selenium
+    #
+    def select_list_elements(identifier)
+      platform.select_lists_for(identifier.clone)
+    end
+    
     #
     # Finds a link
     #
@@ -111,6 +202,25 @@ module PageObject
       platform.link_for(identifier.clone)
     end
     
+    #
+    # Find all links for the provided identifier
+    #
+    # @param [Hash] identifier how we find a link.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :href => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :link => Watir and Selenium
+    #   * :link_text => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :text => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #
+    def link_elements(identifier)
+      platform.links_for(identifier.clone)
+    end
+    
     #
     # Finds a checkbox
     #
@@ -126,6 +236,21 @@ module PageObject
       platform.checkbox_for(identifier.clone)
     end
 
+    #
+    # Finds all checkbox elements for the provided identifier
+    #
+    # @param [Hash] identifier how we find a checkbox.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #
+    def checkbox_elements(identifier)
+      platform.checkboxes_for(identifier.clone)
+    end
+
     #
     # Finds a radio button
     #
@@ -141,6 +266,21 @@ module PageObject
       platform.radio_button_for(identifier.clone)
     end
 
+    #
+    # Finds all radio button elements that match the provided identifier
+    #
+    # @param [Hash] identifier how we find a radio button.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #
+    def radio_button_elements(identifier)
+      platform.radio_buttons_for(identifier.clone)
+    end
+
     #
     # Finds a div
     #
@@ -157,6 +297,22 @@ module PageObject
       platform.div_for(identifier.clone)
     end
 
+    #
+    # Finds all divs that match the provided identifier
+    #
+    # @param [Hash] identifier how we find a div.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :text => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #
+    def div_elements(identifier)
+      platform.divs_for(identifier.clone)
+    end
+
     #
     # Finds a span
     #
@@ -172,6 +328,21 @@ module PageObject
       platform.span_for(identifier.clone)
     end
     
+    #
+    # Finds all span elements that match the provided identifier
+    #
+    # @param [Hash] identifier how we find a span.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #
+    def span_elements(identifier)
+      platform.spans_for(identifier.clone)
+    end
+    
     #
     # Finds a table
     #
@@ -187,6 +358,21 @@ module PageObject
       platform.table_for(identifier.clone)
     end
 
+    #
+    # Finds all tables that match the provided identifier
+    #
+    # @param [Hash] identifier how we find a table.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #
+    def table_elements(identifier)
+      platform.tables_for(identifier.clone)
+    end
+
     #
     # Finds a table cell
     #
@@ -203,6 +389,22 @@ module PageObject
       platform.cell_for(identifier.clone)
     end
     
+    #
+    # Finds all table cell elements that match the provided identifier
+    #
+    # @param [Hash] identifier how we find a cell.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir only
+    #   * :name => Watir and Selenium
+    #   * :text => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #
+    def cell_elements(identifier)
+      platform.cells_for(identifier.clone)
+    end
+    
     #
     # Finds an image
     #
@@ -218,6 +420,21 @@ module PageObject
       platform.image_for(identifier.clone)
     end
     
+    #
+    # Finds all images that match the provided identifier
+    #
+    # @param [Hash] identifier how we find an image.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #
+    def image_elements(identifier)
+      platform.images_for(identifier.clone)
+    end
+    
     #
     # Finds a form
     #
@@ -232,6 +449,20 @@ module PageObject
       platform.form_for(identifier.clone)
     end
 
+    #
+    # Finds all forms that match the provided identifier
+    #
+    # @param [Hash] identifier how we find a form.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #
+    def form_elements(identifier)
+      platform.forms_for(identifier.clone)
+    end
+    
     #
     # Finds a list item
     #
@@ -247,6 +478,21 @@ module PageObject
       platform.list_item_for(identifier.clone)
     end
 
+    #
+    # Finds all list items that match the identifier
+    #
+    # @param [Hash] identifier how we find a list item.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #
+    def list_item_elements(identifier)
+      platform.list_items_for(identifier.clone)
+    end
+
     #
     # Finds an unordered list
     #
@@ -262,6 +508,21 @@ module PageObject
       platform.unordered_list_for(identifier.clone)
     end
 
+    #
+    # Finds all unordered lists that match the identifier
+    #
+    # @param [Hash] identifier how we find an unordered list.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #
+    def unordered_list_elements(identifier)
+      platform.unordered_lists_for(identifier.clone)
+    end
+
     #
     #  Finds an ordered list
     #
@@ -277,6 +538,21 @@ module PageObject
       platform.ordered_list_for(identifier.clone)
     end
     
+    #
+    #  Finds all ordered lists that match the identifier
+    #
+    # @param [Hash] identifier how we find an ordered list.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #
+    def ordered_list_elements(identifier)
+      platform.ordered_lists_for(identifier.clone)
+    end
+    
     #
     # Finds a h1
     #
@@ -292,6 +568,21 @@ module PageObject
       platform.h1_for(identifier.clone)
     end
 
+    #
+    # Finds all h1 elements matching the identifier
+    #
+    # @param [Hash] identifier how we find a H1.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #
+    def h1_elements(identifier)
+      platform.h1s_for(identifier.clone)
+    end
+
     #
     # Finds a h2
     #
@@ -307,6 +598,21 @@ module PageObject
       platform.h2_for(identifier.clone)
     end
 
+    #
+    # Finds all h2 elements matching the identifier
+    #
+    # @param [Hash] identifier how we find a H2.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #
+    def h2_elements(identifier)
+      platform.h2s_for(identifier.clone)
+    end
+
     #
     # Finds a h3
     #
@@ -322,6 +628,21 @@ module PageObject
       platform.h3_for(identifier.clone)
     end
 
+    #
+    # Finds all h3 elements for the identifier
+    #
+    # @param [Hash] identifier how we find a H3.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #
+    def h3_elements(identifier)
+      platform.h3s_for(identifier.clone)
+    end
+
     #
     # Finds a h4
     #
@@ -337,6 +658,21 @@ module PageObject
       platform.h4_for(identifier.clone)
     end
 
+    #
+    # Finds all h4 elements matching the identifier
+    #
+    # @param [Hash] identifier how we find a H4.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #
+    def h4_elements(identifier)
+      platform.h4s_for(identifier.clone)
+    end
+
     #
     # Finds a h5
     #
@@ -352,6 +688,21 @@ module PageObject
       platform.h5_for(identifier.clone)
     end
 
+    #
+    # Finds all h5 elements for the identifier
+    #
+    # @param [Hash] identifier how we find a H5.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #
+    def h5_elements(identifier)
+      platform.h5s_for(identifier.clone)
+    end
+
     #
     # Finds a h6
     #
@@ -367,6 +718,21 @@ module PageObject
       platform.h6_for(identifier.clone)
     end
 
+    #
+    # Finds all h6 elements matching the identifier
+    #
+    # @param [Hash] identifier how we find a H6.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #
+    def h6_elements(identifier)
+      platform.h6s_for(identifier.clone)
+    end
+
     #
     # Finds a paragraph
     #
@@ -382,7 +748,22 @@ module PageObject
       platform.paragraph_for(identifier.clone)
     end
 
-        #
+    #
+    # Finds all paragraph elements
+    #
+    # @param [Hash] identifier how we find a paragraph.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    #
+    def paragraph_elements(identifier)
+      platform.paragraphs_for(identifier.clone)
+    end
+
+    #
     # Finds a paragraph
     #
     # @param [Hash] identifier how we find a paragraph.  You can use a multiple paramaters