page-object 0.2.2 → 0.2.3

data/ChangeLog

@@ -1,3 +1,13 @@
+=== Version 0.2.3 / 2011-08-01
+* Enhancements
+  * Can now find a TableCell by its' text
+  * If we receive an error calling #attach_to_window, wait one second and try again
+  * Will call callback method #initialize_page method if it exists on a page object
+  * Renamed all *_<element_type> methods to *_element.  Created alias for backward compatability
+  * Delegating unknown method calls on Element to the driver element object
+  * Improved block handling when passed to element creation method
+  * Updated to use selenium-webdriver 2.3.2
+
 === Version 0.2.2 / 2011-07-31
 * Enhancements
   * Can find frame by name

data/features/html/static_elements.html

@@ -53,8 +53,7 @@ html>
         </tr>
         <tr>
             <td>Data3</td>
-            <td id='cell_id'
-            , name='cell_name' class='cell_class'>Data4</td>
+            <td id='cell_id' name='cell_name' class='cell_class'>Data4</td>
         </tr>
     </table>
 

data/features/step_definitions/accessor_steps.rb

@@ -181,11 +181,11 @@ When /^I retrieve a table cell element by "([^"]*)" and "([^"]*)"$/ do |param1,
 end
 
 When /^I retrieve a table element by "([^\"]*)"$/ do |how|
-  @element = @page.send "table_#{how}_table"
+  @element = @page.send "table_#{how}_element"
 end
 
 When /^I retrieve a table element by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
-  @element = @page.send "table_#{param1}_#{param2}_table"
+  @element = @page.send "table_#{param1}_#{param2}_element"
 end
 
 When /^I get the image element$/ do
@@ -201,15 +201,15 @@ Then /^the image should be "([^\"]*)" pixels tall$/ do |height|
 end
 
 When /^I get the image element by "([^\"]*)"$/ do |how|
-  @element = @page.send "image_#{how}_image"
+  @element = @page.send "image_#{how}_element"
 end
 
 When /^I get the image element by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
-  @element = @page.send "image_#{param1}_#{param2}_image"
+  @element = @page.send "image_#{param1}_#{param2}_element"
 end
 
 When /^I retrieve the hidden field element$/ do
-  @element = @page.hidden_field_id_hidden_field
+  @element = @page.hidden_field_id_element
 end
 
 Then /^I should see the hidden field contains "([^\"]*)"$/ do |text|
@@ -217,7 +217,7 @@ Then /^I should see the hidden field contains "([^\"]*)"$/ do |text|
 end
 
 When /^I search for the hidden field by "([^\"]*)"$/ do |how|
-  @element = @page.send "hidden_field_#{how}_hidden_field"
+  @element = @page.send "hidden_field_#{how}_element"
 end
 
 Then /^hidden field element should contains "([^\"]*)"$/ do |text|
@@ -225,7 +225,7 @@ Then /^hidden field element should contains "([^\"]*)"$/ do |text|
 end
 
 When /^I search for the hidden field by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
-  @element = @page.send "hidden_field_#{param1}_#{param2}_hidden_field"
+  @element = @page.send "hidden_field_#{param1}_#{param2}_element"
 end
 
 Then /^I should be able to submit the form$/ do
@@ -233,11 +233,11 @@ Then /^I should be able to submit the form$/ do
 end
 
 When /^I locate the form by "([^\"]*)"$/ do |how|
-  @element = @page.send "form_#{how}_form"
+  @element = @page.send "form_#{how}_element"
 end
 
 When /^I locate the form using "([^"]*)" and "([^"]*)"$/ do |param1, param2|
-  @element = @page.send "form_#{param1}_#{param2}_form"
+  @element = @page.send "form_#{param1}_#{param2}_element"
 end
 
 When /^I get the text from the list item$/ do
@@ -253,7 +253,7 @@ When /^I search for the list item by "([^"]*)" and "([^"]*)"$/ do |param1, param
 end
 
 When /^I get the first item from the unordered list$/ do
-  @element = @page.ul_id_unordered_list[0]
+  @element = @page.ul_id_element[0]
 end
 
 Then /^the list items text should be "([^\"]*)"$/ do |expected_text|
@@ -261,11 +261,11 @@ Then /^the list items text should be "([^\"]*)"$/ do |expected_text|
 end
 
 When /^I search for the unordered list by "([^\"]*)"$/ do |how|
-  @list = @page.send "ul_#{how}_unordered_list"
+  @list = @page.send "ul_#{how}_element"
 end
 
 When /^I search for the unordered list by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
-  @list = @page.send "ul_#{param1}_#{param2}_unordered_list"
+  @list = @page.send "ul_#{param1}_#{param2}_element"
 end
 
 
@@ -274,15 +274,15 @@ When /^I get the first item from the list$/ do
 end
 
 When /^I get the first item from the ordered list$/ do
-  @element = @page.ol_id_ordered_list[0]
+  @element = @page.ol_id_element[0]
 end
 
 When /^I search for the ordered list by "([^\"]*)"$/ do |how|
-  @list = @page.send "ol_#{how}_ordered_list"
+  @list = @page.send "ol_#{how}_element"
 end
 
 When /^I search for the ordered list by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
-  @list = @page.send "ol_#{param1}_#{param2}_ordered_list"
+  @list = @page.send "ol_#{param1}_#{param2}_element"
 end
 
 Then /^the table should have "([^\"]*)" rows$/ do |rows|
@@ -315,7 +315,7 @@ Then /^each item should contain "([^\"]*)"$/ do |text|
 end
 
 Then /^option "([^\"]*)" should contain "([^\"]*)"$/ do |opt_num, text|
-  @element = @page.send "sel_list_#{@how}_select_list".to_sym
+  @element = @page.send "sel_list_#{@how}_element".to_sym
   @element[opt_num.to_i - 1].text.should == text
 end
 

data/features/step_definitions/element_steps.rb

@@ -3,50 +3,49 @@ When /^I select a link labeled "([^"]*)" and index "([^"]*)"$/ do |label, index|
 end
 
 When /^I retrieve a check box element$/ do
-  @element = @page.cb_id_checkbox
+  @element = @page.cb_id_element
 end
 
 When /^I retrieve a link element$/ do
-  @element = @page.google_search_id_link
+  @element = @page.google_search_id_element
 end
 
 When /^I retrieve a radio button$/ do
-  @element = @page.milk_id_radio_button
+  @element = @page.milk_id_element
 end
 
 When /^I retrieve a select list$/ do
-  @element = @page.sel_list_id_select_list
+  @element = @page.sel_list_id_element
 end
 
 When /^I retrieve a text field$/ do
-  @element = @page.text_field_id_text_field
+  @element = @page.text_field_id_element
 end
 
 When /^I retrieve the text area$/ do
-  @element = @page.text_area_id_text_area
+  @element = @page.text_area_id_element
 end
 
 When /^I retrieve the div element$/ do
-  @element = @page.div_id_div
+  @element = @page.div_id_element
 end
 
 When /^I retrieve a table element$/ do
-  @element = @page.table_id_table
+  @element = @page.table_id_element
 end
 
 When /^I retrieve a button element$/ do
-  @element = @page.button_id_button
+  @element = @page.button_id_element
 end
 
 When /^I retrieve table cell$/ do
-  @element = @page.cell_id_cell
+  @element = @page.cell_id_element
 end
 
 When /^I locate the form$/ do
-  @element = @page.form_id_form
+  @element = @page.form_id_element
 end
 
-
 Then /^I should know it exists$/ do
   @element.should exist
 end
@@ -94,17 +93,17 @@ Then /^I should be able to click it$/ do
 end
 
 When /^I retrieve a list item element$/ do
-  @element = @page.li_id_list_item
+  @element = @page.li_id_element
 end
 
 When /^I retrieve an unordered list element$/ do
-  @element = @page.ul_id_unordered_list
+  @element = @page.ul_id_element
 end
 
 When /^I retrieve an ordered list element$/ do
-  @element = @page.ol_id_ordered_list
+  @element = @page.ol_id_element
 end
 
 When /^I clear the text field$/ do
-  @page.text_field_id_text_field.clear
+  @page.text_field_id_element.clear
 end

data/features/support/page.rb

@@ -108,6 +108,7 @@ class Page
   cell(:cell_name, :name => 'cell_name')
   cell(:cell_class, :class => 'cell_class')
   cell(:cell_index, :index => 3)
+  cell(:cell_text, :text => 'Data4')
   cell(:cell_xpath, :xpath => '//table//tr[2]//td[2]')
   cell(:cell_class_index, :class => "cell_class", :index => 0)
   cell(:cell_name_index, :name => "cell_name", :index => 0)

data/features/table_cell.feature

@@ -18,6 +18,7 @@ Feature: Table Cell
     | class     |
     | xpath     |
     | name      |
+    | text      |
 
   @watir_only
   Scenario Outline: Locating table cells on the Page with watir

data/lib/page-object.rb

@@ -38,7 +38,8 @@ module PageObject
   attr_reader :platform
 
   #
-  # Construct a new page object.
+  # Construct a new page object.  Upon initialization of the page it will call a method named
+  # initialize_page if it exists.
   #
   # @param [Watir::Browser or Selenium::WebDriver::Driver] the platform browser to use
   # @param [bool] open the page if page_url is set
@@ -46,6 +47,7 @@ module PageObject
   def initialize(browser, visit=false)
     @browser = browser
     include_platform_driver(browser)
+    initialize_page if respond_to?(:initialize_page)
     goto if visit && respond_to?(:goto)
   end
 
@@ -150,7 +152,8 @@ module PageObject
   
   #
   # Attach to a running window.  You can locate the window using either
-  # the window's title or url.
+  # the window's title or url.  If it failes to connect to a window it will
+  # pause for 1 second and try again.
   #
   # @example
   #     page.attach_to_window(:title => "other window's title")
@@ -159,7 +162,12 @@ module PageObject
   # be the entire url - it can just be the page name like index.html
   #
   def attach_to_window(identifier)
-    platform.attach_to_window(identifier)
+    begin
+      platform.attach_to_window(identifier)
+    rescue
+      sleep 1
+      platform.attach_to_window(identifier)
+    end
   end
   
   #
@@ -174,4 +182,8 @@ module PageObject
   def include_platform_driver(browser)
     @platform = load_platform(browser, PageObject::Platforms.get)
   end
+  
+  def call_block(&block)
+      block.arity == 1 ? block.call(self) : self.instance_eval(&block)      
+  end
 end

data/lib/page-object/accessors.rb

@@ -51,7 +51,7 @@ module PageObject
     #
     # @example  
     #   text_field(:first_name, :id => "first_name") 
-    #   # will generate 'first_name', 'first_name=' and 'first_name_text_field' methods
+    #   # will generate 'first_name', 'first_name=' and 'first_name_element' methods
     #
     # @param  [String] the name used for the generated methods
     # @param [Hash] identifier how we find a text field.  You can use a multiple paramaters
@@ -74,18 +74,20 @@ module PageObject
       define_method("#{name}=") do |value|
         platform.text_field_value_set(identifier.clone, value)
       end
-      define_method("#{name}_text_field") do
-        block ? block.call(browser) : platform.text_field_for(identifier.clone)
+      define_method("#{name}_element") do
+        return call_block(&block) if block
+        platform.text_field_for(identifier.clone)
       end
+      alias_method "#{name}_text_field".to_sym, "#{name}_element".to_sym
     end
-
+    
     #
     # adds two methods to the page object - one to get the text from a hidden field
     # and another to retrieve the hidden field element.
     #
     # @example
     #   hidden_field(:user_id, :id => "user_identity")
-    #   # will generate 'user_id' and 'user_id_hidden_field' methods
+    #   # will generate 'user_id' and 'user_id_element' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a hidden field.  You can use a multiple paramaters
@@ -104,9 +106,11 @@ module PageObject
       define_method(name) do
         platform.hidden_field_value_for identifier.clone
       end
-      define_method("#{name}_hidden_field") do
-        block ? block.call(browser) : platform.hidden_field_for(identifier.clone)
+      define_method("#{name}_element") do
+        return call_block(&block) if block
+        platform.hidden_field_for(identifier.clone)
       end
+      alias_method "#{name}_hidden_field".to_sym, "#{name}_element".to_sym
     end
 
     #
@@ -116,7 +120,7 @@ module PageObject
     #
     # @example
     #   text_area(:address, :id => "address")
-    #   # will generate 'address', 'address=' and 'address_text_area methods
+    #   # will generate 'address', 'address=' and 'address_element methods
     #
     # @param  [String] the name used for the generated methods
     # @param [Hash] identifier how we find a text area.  You can use a multiple paramaters
@@ -137,9 +141,11 @@ module PageObject
       define_method("#{name}=") do |value|
         platform.text_area_value_set(identifier.clone, value)
       end
-      define_method("#{name}_text_area") do
-        block ? block.call(browser) : platform.text_area_for(identifier.clone)
+      define_method("#{name}_element") do
+        return call_block(&block) if block
+        platform.text_area_for(identifier.clone)
       end
+      alias_method "#{name}_text_area".to_sym, "#{name}_element".to_sym
     end
 
     #
@@ -149,7 +155,7 @@ module PageObject
     #
     # @example
     #   select_list(:state, :id => "state")
-    #   # will generate 'state', 'state=' and 'state_select_list' methods
+    #   # will generate 'state', 'state=' and 'state_element' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a select list.  You can use a multiple paramaters
@@ -170,9 +176,11 @@ module PageObject
       define_method("#{name}=") do |value|
         platform.select_list_value_set(identifier.clone, value)
       end
-      define_method("#{name}_select_list") do
-        block ? block.call(browser) : platform.select_list_for(identifier.clone)
+      define_method("#{name}_element") do
+        return call_block(&block) if block
+        platform.select_list_for(identifier.clone)
       end
+      alias_method "#{name}_select_list".to_sym, "#{name}_element".to_sym
     end
 
     #
@@ -182,7 +190,7 @@ module PageObject
     #
     # @example
     #   link(:add_to_cart, :text => "Add to Cart")
-    #   # will generate 'add_to_cart' and 'add_to_cart_link' methods
+    #   # will generate 'add_to_cart' and 'add_to_cart_element' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a link.  You can use a multiple paramaters
@@ -202,9 +210,11 @@ module PageObject
       define_method(name) do
         platform.click_link_for identifier.clone
       end
-      define_method("#{name}_link") do
-        block ? block.call(browser) : platform.link_for(identifier.clone)
+      define_method("#{name}_element") do
+        return call_block(&block) if block
+        platform.link_for(identifier.clone)
       end
+      alias_method "#{name}_link".to_sym, "#{name}_element".to_sym
     end
 
     #
@@ -214,7 +224,7 @@ module PageObject
     #
     # @example
     #   checkbox(:active, :name => "is_active")
-    #   # will generate 'check_active', 'uncheck_active', 'active_checked?' and 'active_checkbox' methods
+    #   # will generate 'check_active', 'uncheck_active', 'active_checked?' and 'active_element' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a checkbox.  You can use a multiple paramaters
@@ -236,9 +246,11 @@ module PageObject
       define_method("#{name}_checked?") do
         platform.checkbox_checked?(identifier.clone)
       end
-      define_method("#{name}_checkbox") do
-        block ? block.call(browser) : platform.checkbox_for(identifier.clone)
+      define_method("#{name}_element") do
+        return call_block(&block) if block
+        platform.checkbox_for(identifier.clone)
       end
+      alias_method "#{name}_checkbox".to_sym, "#{name}_element".to_sym
     end
 
     #
@@ -249,7 +261,7 @@ module PageObject
     #
     # @example
     #   radio_button(:north, :id => "north")
-    #   # will generate 'select_north', 'clear_north', 'north_selected?' and 'north_radio_button' methods
+    #   # will generate 'select_north', 'clear_north', 'north_selected?' and 'north_element' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a radio button.  You can use a multiple paramaters
@@ -271,9 +283,11 @@ module PageObject
       define_method("#{name}_selected?") do
         platform.radio_selected?(identifier.clone)
       end
-      define_method("#{name}_radio_button") do
-        block ? block.call(browser) : platform.radio_button_for(identifier.clone)
+      define_method("#{name}_element") do
+        return call_block(&block) if block
+        platform.radio_button_for(identifier.clone)
       end
+      alias_method "#{name}_radio_button".to_sym, "#{name}_element".to_sym
     end
 
     #
@@ -282,7 +296,7 @@ module PageObject
     #
     # @example
     #   button(:purchase, :id => 'purchase')
-    #   # will generate 'purchase' and 'purchase_button' methods
+    #   # will generate 'purchase' and 'purchase_element' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a button.  You can use a multiple paramaters
@@ -299,9 +313,11 @@ module PageObject
       define_method(name) do
         platform.click_button_for identifier.clone
       end
-      define_method("#{name}_button") do
-        block ? block.call(browser) : platform.button_for(identifier.clone)
+      define_method("#{name}_element") do
+        return call_block(&block) if block
+        platform.button_for(identifier.clone)
       end
+      alias_method "#{name}_button".to_sym, "#{name}_element".to_sym
     end
 
     #
@@ -310,7 +326,7 @@ module PageObject
     #
     # @example
     #   div(:message, :id => 'message')
-    #   # will generate 'message' and 'message_div' methods
+    #   # will generate 'message' and 'message_element' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a div.  You can use a multiple paramaters
@@ -327,9 +343,11 @@ module PageObject
       define_method(name) do
         platform.div_text_for identifier.clone
       end
-      define_method("#{name}_div") do
-        block ? block.call(browser) : platform.div_for(identifier.clone)
+      define_method("#{name}_element") do
+        return call_block(&block) if block
+        platform.div_for(identifier.clone)
       end
+      alias_method "#{name}_div".to_sym, "#{name}_element".to_sym
     end
 
     #
@@ -338,7 +356,7 @@ module PageObject
     #
     # @example
     #   span(:alert, :id => 'alert')
-    #   # will generate 'alert' and 'alert_span' methods
+    #   # will generate 'alert' and 'alert_element' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a span.  You can use a multiple paramaters
@@ -354,9 +372,11 @@ module PageObject
       define_method(name) do
         platform.span_text_for identifier.clone
       end
-      define_method("#{name}_span") do
-        block ? block.call(browser) : platform.span_for(identifier.clone)
+      define_method("#{name}_element") do
+        return call_block(&block) if block
+        platform.span_for(identifier.clone)
       end
+      alias_method "#{name}_span".to_sym, "#{name}_element".to_sym
     end
 
     #
@@ -364,7 +384,7 @@ module PageObject
     #
     # @example
     #   table(:cart, :id => 'shopping_cart')
-    #   # will generate a 'cart_table' method
+    #   # will generate a 'cart_element' method
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a table.  You can use a multiple paramaters
@@ -377,9 +397,11 @@ module PageObject
     # @param optional block to be invoked when element method is called
     #
     def table(name, identifier=nil, &block)
-      define_method("#{name}_table") do
-        block ? block.call(browser) : platform.table_for(identifier.clone)
+      define_method("#{name}_element") do
+        return call_block(&block) if block
+        platform.table_for(identifier.clone)
       end
+      alias_method "#{name}_table".to_sym, "#{name}_element".to_sym
     end
 
     #
@@ -388,7 +410,7 @@ module PageObject
     #
     # @example
     #   cell(:total, :id => 'total_cell')
-    #   # will generate 'total' and 'total_cell' methods
+    #   # will generate 'total' and 'total_element' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a cell.  You can use a multiple paramaters
@@ -397,6 +419,7 @@ module PageObject
     #   * :id => Watir and Selenium
     #   * :index => Watir only
     #   * :name => Watir and Selenium
+    #   * :text => Watir and Selenium
     #   * :xpath => Watir and Selenium
     # @param optional block to be invoked when element method is called
     #
@@ -404,9 +427,11 @@ module PageObject
       define_method("#{name}") do
         platform.cell_text_for identifier.clone
       end
-      define_method("#{name}_cell") do
-        block ? block.call(browser) : platform.cell_for(identifier.clone)
+      define_method("#{name}_element") do
+        return call_block(&block) if block
+        platform.cell_for(identifier.clone)
       end
+      alias_method "#{name}_cell".to_sym, "#{name}_element".to_sym
     end
 
     #
@@ -414,7 +439,7 @@ module PageObject
     #
     # @example
     #   image(:logo, :id => 'logo')
-    #   # will generate a 'logo_image' method
+    #   # will generate a 'logo_element' method
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find an image.  You can use a multiple paramaters
@@ -427,9 +452,11 @@ module PageObject
     # @param optional block to be invoked when element method is called
     #
     def image(name, identifier=nil, &block)
-      define_method("#{name}_image") do
-        block ? block.call(browser) : platform.image_for(identifier.clone)
+      define_method("#{name}_element") do
+        return call_block(&block) if block
+        platform.image_for(identifier.clone)
       end
+      alias_method "#{name}_image".to_sym, "#{name}_element".to_sym
     end
 
     #
@@ -437,7 +464,7 @@ module PageObject
     #
     # @example
     #   form(:login, :id => 'login')
-    #   # will generate a 'login_form' method
+    #   # will generate a 'login_element' method
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a form.  You can use a multiple paramaters
@@ -449,9 +476,11 @@ module PageObject
     # @param optional block to be invoked when element method is called
     #
     def form(name, identifier=nil, &block)
-      define_method("#{name}_form") do
-        block ? block.call(browser) : platform.form_for(identifier.clone)
+      define_method("#{name}_element") do
+        return call_block(&block) if block
+        platform.form_for(identifier.clone)
       end
+      alias_method "#{name}_form".to_sym, "#{name}_element".to_sym
     end
 
     #
@@ -460,7 +489,7 @@ module PageObject
     #
     # @example
     #   list_item(:item_one, :id => 'one')
-    #   # will generate 'item_one' and 'item_one_list_item' methods
+    #   # will generate 'item_one' and 'item_one_element' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a list item.  You can use a multiple paramaters
@@ -476,9 +505,11 @@ module PageObject
       define_method(name) do
         platform.list_item_text_for identifier.clone
       end
-      define_method("#{name}_list_item") do
-        block ? block.call(browser) : platform.list_item_for(identifier.clone)
+      define_method("#{name}_element") do
+        return call_block(&block) if block
+        platform.list_item_for(identifier.clone)
       end
+      alias_method "#{name}_list_item".to_sym, "#{name}_element".to_sym
     end
 
     #
@@ -486,7 +517,7 @@ module PageObject
     #
     # @example
     #   unordered_list(:menu, :id => 'main_menu')
-    #   # will generate a 'menu_unordered_list' method
+    #   # will generate a 'menu_element' method
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find an unordered list.  You can use a multiple paramaters
@@ -499,9 +530,11 @@ module PageObject
     # @param optional block to be invoked when element method is called
     #
     def unordered_list(name, identifier=nil, &block)
-      define_method("#{name}_unordered_list") do
-        block ? block.call(browser) : platform.unordered_list_for(identifier.clone)
+      define_method("#{name}_element") do
+        return call_block(&block) if block
+        platform.unordered_list_for(identifier.clone)
       end
+      alias_method "#{name}_unordered_list".to_sym, "#{name}_element".to_sym
     end
 
     #
@@ -509,7 +542,7 @@ module PageObject
     #
     # @example
     #   ordered_list(:top_five, :id => 'top')
-    #   # will generate a 'top_five_ordered_list' method
+    #   # will generate a 'top_five_element' method
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find an ordered list.  You can use a multiple paramaters
@@ -522,9 +555,11 @@ module PageObject
     # @param optional block to be invoked when element method is called
     #
     def ordered_list(name, identifier=nil, &block)
-      define_method("#{name}_ordered_list") do
-        block ? block.call(browser) : platform.ordered_list_for(identifier.clone)
+      define_method("#{name}_element") do
+        return call_block(&block) if block
+        platform.ordered_list_for(identifier.clone)
       end
+      alias_method "#{name}_ordered_list".to_sym, "#{name}_element".to_sym
     end
   end
 end