page-object 0.7.5.1 → 0.7.6

data/features/step_definitions/page_level_actions_steps.rb

@@ -86,6 +86,10 @@ When /^I open a second window$/ do
   @page.open_window
 end
 
+When /^I open a third window$/ do
+  @page.open_another_window
+end
+
 class SecondPage
   include PageObject
 end
@@ -93,11 +97,13 @@ end
 Then /^I should be able to attach to a page object using title$/ do
   @second_page = SecondPage.new(@browser)
   @second_page.attach_to_window(:title => "Success")
+  @second_page.title.should == "Success"
 end
 
 Then /^I should be able to attach to a page object using url$/ do
   @second_page = SecondPage.new(@browser)
   @second_page.attach_to_window(:url => "success.html")
+  @second_page.current_url.should include 'success.html'
 end
 
 Then /^I should be able to refresh the page$/ do

data/features/step_definitions/span_steps.rb

@@ -16,4 +16,4 @@ end
 
 Then /^I should see that the span exists$/ do
   @page.span_id?.should == true
-end
+end

data/features/support/page.rb

@@ -24,6 +24,7 @@ class Page
 
   text_area(:text_area_id, :id => "text_area_id")
   text_area(:text_area_class, :class => "text_area_class")
+  text_area(:text_area_css, :css => ".text_area_class")
   text_area(:text_area_name, :name => "text_area_name")
   text_area(:text_area_xpath, :xpath => "//textarea")
   text_area(:text_area_css, :css => "textarea")
@@ -36,6 +37,7 @@ class Page
 
   hidden_field(:hidden_field_id, :id => "hidden_field_id")
   hidden_field(:hidden_field_class, :class => "hidden_field_class")
+  hidden_field(:hidden_field_css, :css => ".hidden_field_class")
   hidden_field(:hidden_field_name, :name => "hidden_field_name")
   hidden_field(:hidden_field_xpath, :xpath => "//input[@type='hidden']")
   hidden_field(:hidden_field_css, :css => "input[type='hidden']")
@@ -49,6 +51,7 @@ class Page
   link(:google_search_id, :id => "link_id")
   link(:google_search_name, :name => "link_name")
   link(:google_search_class, :class => "link_class")
+  link(:google_search_css, :css => ".link_class")
   link(:google_search_xpath, :xpath => "//a[text()='Google Search']")
   link(:google_search_link, :link => "Google Search")
   link(:google_search_link_text, :link_text => "Google Search")
@@ -73,6 +76,7 @@ class Page
   checkbox(:cb_id, :id => 'cb_id')
   checkbox(:cb_name, :name => 'cb_name')
   checkbox(:cb_class, :class => 'cb_class')
+  checkbox(:cb_css, :css => '.cb_class')
   checkbox(:cb_index, :index => 0)
   checkbox(:cb_xpath, :xpath => "//input[@type='checkbox']")
   checkbox(:cb_value, :value => '1')
@@ -82,6 +86,7 @@ class Page
   radio_button(:milk_id, :id => 'milk_id')
   radio_button(:milk_name, :name => 'milk_name')
   radio_button(:milk_class, :class => 'milk_class')
+  radio_button(:milk_css, :css => '.milk_class')
   radio_button(:milk_index, :index => 0)
   radio_button(:milk_value, :value => 'Milk')
   radio_button(:milk_xpath, :xpath => "//input[@type='radio']")
@@ -93,6 +98,7 @@ class Page
   div(:div_id, :id => 'div_id')
   div(:div_name, :name => 'div_name')
   div(:div_class, :class => 'div_class')
+  div(:div_css, :css => '.div_class')
   div(:div_text, :text => 'page-object rocks!')
   div(:div_index, :index => 0)
   div(:div_xpath, :xpath => '//div')
@@ -104,6 +110,7 @@ class Page
   span(:span_id, :id => 'span_id')
   span(:span_name, :name => 'span_name')
   span(:span_class, :class => 'span_class')
+  span(:span_css, :css => '.span_class')
   span(:span_index, :index => 0)
   span(:span_text, :text => 'My alert')
   span(:span_title, :title => 'span_title')
@@ -114,6 +121,7 @@ class Page
   table(:table_id, :id => 'table_id')
   table(:table_name, :name => 'table_name')
   table(:table_class, :class => 'table_class')
+  table(:table_css, :css => '.table_class')
   table(:table_index, :index => 0)
   table(:table_xpath, :xpath => '//table')
   table(:table_class_index, :class => "table_class", :index => 0)
@@ -123,6 +131,7 @@ class Page
   cell(:cell_id, :id => 'cell_id')
   cell(:cell_name, :name => 'cell_name')
   cell(:cell_class, :class => 'cell_class')
+  cell(:cell_css, :css => '.cell_class')
   cell(:cell_index, :index => 3)
   cell(:cell_text, :text => 'Data4')
   cell(:cell_xpath, :xpath => '//table//tr[2]//td[2]')
@@ -132,6 +141,7 @@ class Page
   button(:button_id, :id => 'button_id')
   button(:button_name, :name => 'button_name')
   button(:button_class, :class => 'button_class')
+  button(:button_css, :css => '.button_class')
   button(:button_index, :index => 0)
   button(:button_xpath, :xpath=> "//input[@type='submit']")
   button(:button_text, :text => 'Click Me')
@@ -147,6 +157,7 @@ class Page
   button(:btn_id, :id => 'btn_id')
   button(:btn_name, :name => 'btn_name')
   button(:btn_class, :class => 'btn_class')
+  button(:btn_css, :css => '.btn_class')
   button(:btn_index, :index => 0)
   button(:btn_text, :text => 'Click Me Too')
   button(:btn_value, :value => 'Click Me Too')
@@ -159,6 +170,7 @@ class Page
   image(:image_id, :id => 'image_id')
   image(:image_name, :name => 'image_name')
   image(:image_class, :class => 'image_class')
+  image(:image_css, :css => '.image_class')
   image(:image_index, :index => 1)
   image(:image_xpath, :xpath => '//img[2]')
   image(:image_alt, :alt => 'image_alt')
@@ -169,6 +181,7 @@ class Page
   form(:form_id, :id => 'form_id')
   form(:form_name, :id => 'form_name')
   form(:form_class, :class => 'form_class')
+  form(:form_css, :css => '.form_class')
   form(:form_index, :index => 0)
   form(:form_xpath, :xpath => '//form')
   form(:form_action, :action => "success.html")
@@ -178,6 +191,7 @@ class Page
   list_item(:li_id, :id => 'li_id')
   list_item(:li_name, :name => 'li_name')
   list_item(:li_class, :class => 'li_class')
+  list_item(:li_css, :css => '.li_class')
   list_item(:li_index, :index => 0)
   list_item(:li_text, :text => 'Item One')
   list_item(:li_xpath, :xpath => '//li[1]')
@@ -187,6 +201,7 @@ class Page
   unordered_list(:ul_id, :id => 'ul_id')
   unordered_list(:ul_name, :name => 'ul_name')
   unordered_list(:ul_class, :class => 'ul_class')
+  unordered_list(:ul_css, :css => '.ul_class')
   unordered_list(:ul_index, :index => 0)
   unordered_list(:ul_xpath, :xpath => '//ul')
   unordered_list(:ul_class_index, :class => "ul_class", :index => 0)
@@ -195,6 +210,7 @@ class Page
   ordered_list(:ol_id, :id => 'ol_id')
   ordered_list(:ol_name, :name => 'ol_name')
   ordered_list(:ol_class, :class => 'ol_class')
+  ordered_list(:ol_css, :css => '.ol_class')
   ordered_list(:ol_index, :index => 0)
   ordered_list(:ol_xpath, :xpath => '//ol')
   ordered_list(:ol_class_index, :class => "ol_class", :index => 0)
@@ -202,6 +218,7 @@ class Page
 
   h1(:h1_id, :id => 'h1_id')
   h1(:h1_class, :class => 'h1_class')
+  h1(:h1_css, :css => '.h1_class')
   h1(:h1_name, :name => 'h1_name')
   h1(:h1_index, :index => 0)
   h1(:h1_xpath, :xpath => '//h1')
@@ -210,6 +227,7 @@ class Page
 
   h2(:h2_id, :id => 'h2_id')
   h2(:h2_class, :class => 'h2_class')
+  h2(:h2_css, :css => '.h2_class')
   h2(:h2_name, :name => 'h2_name')
   h2(:h2_index, :index => 0)
   h2(:h2_xpath, :xpath => '//h2')
@@ -218,6 +236,7 @@ class Page
 
   h3(:h3_id, :id => 'h3_id')
   h3(:h3_class, :class => 'h3_class')
+  h3(:h3_css, :css => '.h3_class')
   h3(:h3_name, :name => 'h3_name')
   h3(:h3_index, :index => 0)
   h3(:h3_xpath, :xpath => '//h3')
@@ -226,6 +245,7 @@ class Page
 
   h4(:h4_id, :id => 'h4_id')
   h4(:h4_class, :class => 'h4_class')
+  h4(:h4_css, :css => '.h4_class')
   h4(:h4_name, :name => 'h4_name')
   h4(:h4_index, :index => 0)
   h4(:h4_xpath, :xpath => '//h4')
@@ -234,6 +254,7 @@ class Page
 
   h5(:h5_id, :id => 'h5_id')
   h5(:h5_class, :class => 'h5_class')
+  h5(:h5_css, :css => '.h5_class')
   h5(:h5_name, :name => 'h5_name')
   h5(:h5_index, :index => 0)
   h5(:h5_xpath, :xpath => '//h5')
@@ -242,6 +263,7 @@ class Page
 
   h6(:h6_id, :id => 'h6_id')
   h6(:h6_class, :class => 'h6_class')
+  h6(:h6_css, :css => '.h6_class')
   h6(:h6_name, :name => 'h6_name')
   h6(:h6_index, :index => 0)
   h6(:h6_xpath, :xpath => '//h6')
@@ -250,6 +272,7 @@ class Page
 
   paragraph(:p_id, :id => 'p_id')
   paragraph(:p_class, :class => 'p_class')
+  paragraph(:p_css, :css => '.p_class')
   paragraph(:p_name, :name => 'p_name')
   paragraph(:p_index, :index => 0)
   paragraph(:p_xpath, :xpath => '//p')
@@ -265,6 +288,7 @@ class Page
   file_field(:file_field_id, :id => 'file_field_id')
   file_field(:file_field_name, :name => 'file_field_name')
   file_field(:file_field_class, :class => 'file_field_class')
+  file_field(:file_field_css, :css => '.file_field_class')
   file_field(:file_field_index, :index => 0)
   file_field(:file_field_title, :title => 'file_field_title')
   file_field(:file_field_class_index, :class => 'file_field_class', :index => 0)
@@ -274,6 +298,7 @@ class Page
   label(:label_id, :id => 'label_id')
   label(:label_name, :name => 'label_name')
   label(:label_class, :class => 'label_class')
+  label(:label_css, :css => '.label_class')
   label(:label_text, :text => 'page-object is the best!')
   label(:label_index, :index => 1)
   label(:label_xpath, :xpath => '//label[2]')
@@ -281,11 +306,13 @@ class Page
   label(:label_name_index, :name => "label_name", :index => 0)
 
   link(:open_window, :text => 'New Window')
+  link(:open_another_window, :text => 'Another New Window')
   link(:child, :id => 'child')
 
   area(:area_id, :id => 'area')
   area(:area_name, :name => 'area')
   area(:area_class, :class => 'area')
+  area(:area_css, :css => '.area')
   area(:area_index, :index => 0)
   area(:area_xpath, :xpath => '//area')
   area(:area_class_index, :class => 'area', :index => 0)
@@ -294,6 +321,7 @@ class Page
   canvas(:canvas_id, :id => 'canvas')
   canvas(:canvas_name, :name => 'canvas')
   canvas(:canvas_class, :class => 'canvas')
+  canvas(:canvas_css, :css => '.canvas')
   canvas(:canvas_index, :index => 0)
   canvas(:canvas_xpath, :xpath => '//canvas')
   canvas(:canvas_class_index, :class => 'canvas', :index => 0)
@@ -302,6 +330,7 @@ class Page
   audio(:audio_id, :id => 'audio')
   audio(:audio_name, :name => 'audio')
   audio(:audio_class, :class => 'audio')
+  audio(:audio_css, :css => '.audio')
   audio(:audio_index, :index => 0)
   audio(:audio_xpath, :xpath => '//audio')
   audio(:audio_class_index, :class => 'audio', :index => 0)
@@ -310,6 +339,7 @@ class Page
   video(:video_id, :id => 'video')
   video(:video_name, :name => 'video')
   video(:video_class, :class => 'video')
+  video(:video_css, :css => '.video')
   video(:video_index, :index => 0)
   video(:video_xpath, :xpath => '//video')
   video(:video_class_index, :class => 'video', :index => 0)

data/features/support/url_helper.rb

@@ -8,7 +8,6 @@ module UrlHelper
       "file://#{html}"
     end
 
-
     def static_elements
       "#{files}/static_elements.html"
     end
@@ -48,5 +47,9 @@ module UrlHelper
     def hover
       "#{files}/hover.html"
     end
+
+    def double_click
+      "#{files}/double_click.html"
+    end
   end
 end

data/features/table.feature

@@ -86,6 +86,15 @@ Feature: Table
     | index     |
     | name      |
 
+  @selenium_only
+  Scenario Outline: Locating table cells on the Page
+    When I retrieve a table element by "<search_by>"
+    Then the data for row "1" should be "Data1" and "Data2"
+
+  Scenarios:
+    | search_by |
+    | css       |
+
   Scenario Outline: Locating table using multiple parameters
     When I retrieve a table element by "<param1>" and "<param2>"
     Then the data for row "1" should be "Data1" and "Data2"

data/features/table_cell.feature

@@ -20,6 +20,15 @@ Feature: Table Cell
     | name      |
     | text      |
 
+  @selenium_only
+  Scenario Outline: Locating table cells on the Page
+    When I search for the table cell by "<search_by>"
+    Then the cell data should be 'Data4'
+
+  Scenarios:
+    | search_by |
+    | css       |
+
   @watir_only
   Scenario Outline: Locating table cells on the Page with watir
     When I search for the table cell by "<search_by>"

data/features/text_area.feature

@@ -20,6 +20,14 @@ Feature: Text Area
     | xpath     |
     | index     |
 
+  @selenium_only
+  Scenario Outline: Locating text area on the Page
+    When I search for the text area by "<search_by>"
+    Then I should be able to type "I found it" into the area
+
+  Scenarios:
+    | search_by |
+    | css       |
 
   Scenario Outline: Locating a text area using multiple parameters
     When I search for the text area by "<param1>" and "<param2>"

data/features/unordered_list.feature

@@ -22,6 +22,18 @@ Feature: Unordered list
     | index     |
     | name      |
 
+  @selenium_only
+  Scenario Outline: Locating unordered lists on the page
+    When I search for the unordered list by "<search_by>"
+    And I get the first item from the list
+    Then the list items text should be "Item One"
+    And the list should contain 3 items
+    And each item should contain "Item"
+
+  Scenarios:
+    | search_by |
+    | css       |
+
   Scenario Outline: Locating unordered lists using multiple parameters
     When I search for the unordered list by "<param1>" and "<param2>"
     And I get the first item from the list

data/features/video.feature

@@ -20,6 +20,15 @@ Feature: Support for video element
     | xpath     |
     | index     |
 
+  @selenium_only
+  Scenario Outline: Locating a video element on the page
+    When I search for the video element by "<search_by>"
+    Then I should know it is visible
+
+  Scenarios:
+    | search_by |
+    | css       |
+
   Scenario Outline: Locating videos using multiple parameters
     When I search for the video element by "<param1>" and "<param2>"
     Then I should know it is visible

data/lib/page-object.rb

@@ -48,13 +48,15 @@ module PageObject
   attr_reader :platform
 
   #
-  # Construct a new page object.  Upon initialization of the page it will call a method named
-  # initialize_page if it exists.
+  # Construct a new page object.  Prior to browser initialization it will call
+  # a method named initialize_accessors if it exists. 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
   #
   def initialize(browser, visit=false)
+    initialize_accessors if respond_to?(:initialize_accessors)
     initialize_browser(browser)
     goto if visit && respond_to?(:goto)
     initialize_page if respond_to?(:initialize_page)

data/lib/page-object/accessors.rb

@@ -164,6 +164,7 @@ module PageObject
     # @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 => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -203,6 +204,7 @@ module PageObject
     # @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 => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -331,6 +333,7 @@ module PageObject
     # @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
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -378,6 +381,7 @@ module PageObject
     # @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
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -498,6 +502,7 @@ module PageObject
     # @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
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -535,6 +540,7 @@ module PageObject
     # @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
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -566,6 +572,7 @@ module PageObject
     # @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
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -603,6 +610,7 @@ module PageObject
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :alt => Watir and Selenium
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -636,6 +644,7 @@ module PageObject
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :action => Watir and Selenium
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :xpath => Watir and Selenium
@@ -666,6 +675,7 @@ module PageObject
     # @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
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -702,6 +712,7 @@ module PageObject
     # @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
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -733,6 +744,7 @@ module PageObject
     # @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
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -764,6 +776,7 @@ module PageObject
     # @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
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -798,6 +811,7 @@ module PageObject
     # @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
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -832,6 +846,7 @@ module PageObject
     # @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
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -866,6 +881,7 @@ module PageObject
     # @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
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -900,6 +916,7 @@ module PageObject
     # @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
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -934,6 +951,7 @@ module PageObject
     # @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
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -968,6 +986,7 @@ module PageObject
     # @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
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1003,6 +1022,7 @@ module PageObject
     # @param [Hash] identifier how we find a file_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 => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1037,6 +1057,7 @@ module PageObject
     # @param [Hash] identifier how we find a label.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1072,6 +1093,7 @@ module PageObject
     # @param [Hash] identifier how we find an 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 => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1106,6 +1128,7 @@ module PageObject
     # @param [Hash] identifier how we find a canvas.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1135,6 +1158,7 @@ module PageObject
     # @param [Hash] identifier how we find an audio element.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1164,6 +1188,7 @@ module PageObject
     # @param [Hash] identifier how we find a video element.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1194,6 +1219,7 @@ module PageObject
     # @param [Hash] identifier how we find an element.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1225,6 +1251,7 @@ module PageObject
     # @param [Hash] identifier how we find an abbr.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1247,6 +1274,7 @@ module PageObject
     # @param [Hash] identifier how we find an address.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1269,6 +1297,7 @@ module PageObject
     # @param [Hash] identifier how we find an article.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1291,6 +1320,7 @@ module PageObject
     # @param [Hash] identifier how we find an aside.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1313,6 +1343,7 @@ module PageObject
     # @param [Hash] identifier how we find an bdi.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1335,6 +1366,7 @@ module PageObject
     # @param [Hash] identifier how we find an bdo.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1357,6 +1389,7 @@ module PageObject
     # @param [Hash] identifier how we find an cite.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1379,6 +1412,7 @@ module PageObject
     # @param [Hash] identifier how we find an code.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1401,6 +1435,7 @@ module PageObject
     # @param [Hash] identifier how we find an dd.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1423,6 +1458,7 @@ module PageObject
     # @param [Hash] identifier how we find an dfn.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1445,6 +1481,7 @@ module PageObject
     # @param [Hash] identifier how we find an dt.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1467,6 +1504,7 @@ module PageObject
     # @param [Hash] identifier how we find an em.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1489,6 +1527,7 @@ module PageObject
     # @param [Hash] identifier how we find an figcaption.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1511,6 +1550,7 @@ module PageObject
     # @param [Hash] identifier how we find an figure.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1533,6 +1573,7 @@ module PageObject
     # @param [Hash] identifier how we find an footer.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1555,6 +1596,7 @@ module PageObject
     # @param [Hash] identifier how we find an header.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1577,6 +1619,7 @@ module PageObject
     # @param [Hash] identifier how we find an hgroup.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1599,6 +1642,7 @@ module PageObject
     # @param [Hash] identifier how we find an kbd.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1621,6 +1665,7 @@ module PageObject
     # @param [Hash] identifier how we find an mark.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1643,6 +1688,7 @@ module PageObject
     # @param [Hash] identifier how we find an nav.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1665,6 +1711,7 @@ module PageObject
     # @param [Hash] identifier how we find an noscript.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1687,6 +1734,7 @@ module PageObject
     # @param [Hash] identifier how we find an rp.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1709,6 +1757,7 @@ module PageObject
     # @param [Hash] identifier how we find an rt.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1731,6 +1780,7 @@ module PageObject
     # @param [Hash] identifier how we find an ruby.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1753,6 +1803,7 @@ module PageObject
     # @param [Hash] identifier how we find an samp.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1775,6 +1826,7 @@ module PageObject
     # @param [Hash] identifier how we find an section.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1797,6 +1849,7 @@ module PageObject
     # @param [Hash] identifier how we find an sub.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1819,6 +1872,7 @@ module PageObject
     # @param [Hash] identifier how we find an summary.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1841,6 +1895,7 @@ module PageObject
     # @param [Hash] identifier how we find an sup.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1863,6 +1918,7 @@ module PageObject
     # @param [Hash] identifier how we find an var.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -1885,6 +1941,7 @@ module PageObject
     # @param [Hash] identifier how we find an wbr.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
+    #   * :css => Selenium only
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium