page-object 0.7.0 → 0.7.1

data/lib/page-object/element_locators.rb

@@ -881,6 +881,36 @@ module PageObject
       platform.file_fields_for(identifier.clone)
     end
 
+    #
+    # Finds an area
+    #
+    # @param [Hash] identifier how we find an area.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  It defaults to {:index => 0}
+    #   which will return the first file field.  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 area_element(identifier={:index => 0})
+      platform.area_for(identifier.clone)
+    end
+
+    #
+    # Finds all areas that match the provided identifier
+    #
+    # @param [Hash] identifier how we find an area.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  It defaults to and empty Hash
+    #   which will return all file fields.  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 area_elements(identifier={})
+      platform.areas_for(identifier.clone)
+    end
+
     #
     # Finds an element
     #

data/lib/page-object/elements.rb

@@ -50,4 +50,5 @@ require 'page-object/elements/heading'
 require 'page-object/elements/paragraph'
 require 'page-object/elements/label'
 require 'page-object/elements/file_field'
+require 'page-object/elements/area'
 

data/lib/page-object/elements/area.rb

@@ -0,0 +1,31 @@
+
+module PageObject
+  module Elements
+    class Area < Element
+
+      #
+      # return the coordinates of the area
+      #
+      def coords
+        attribute(:coords)
+      end
+
+      #
+      # return the shape of the area
+      #
+      def shape
+        attribute(:shape)
+      end
+
+      #
+      # return the href of the area
+      #
+      def href
+        attribute(:href)
+      end
+
+    end
+
+    ::PageObject::Elements.type_to_class[:area] = ::PageObject::Elements::Area
+  end
+end

data/lib/page-object/elements/element.rb

@@ -105,7 +105,7 @@ module PageObject
       protected
 
       def self.should_build_watir_xpath identifier
-        ['table', 'span', 'div', 'td', 'li', 'ul', 'ol', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'p', 'label'].include? identifier[:tag_name] and identifier[:name]
+        ['table', 'span', 'div', 'td', 'li', 'ul', 'ol', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'p', 'label', 'area'].include? identifier[:tag_name] and identifier[:name]
       end
 
       def self.build_xpath_for identifier

data/lib/page-object/platforms/selenium_webdriver/page_object.rb

@@ -863,6 +863,29 @@ module PageObject
           find_selenium_elements(identifier, Elements::FileField, 'input', :type => 'file')
         end
 
+        #
+        # platform method to click on an area
+        #
+        def click_area_for(identifier)
+          process_selenium_call(identifier, Elements::Area, 'area') do |how, what|
+            @browser.find_element(how, what).click
+          end
+        end
+
+        #
+        # platform method to retrieve an area element
+        #
+        def area_for(identifier)
+          find_selenium_element(identifier, Elements::Area, 'area')
+        end
+
+        #
+        # platform method to return an array of area elements
+        #
+        def areas_for(identifier)
+          find_selenium_elements(identifier, Elements::Area, 'area')
+        end
+        
         #
         # platform method to retrieve a generic element
         # See PageObject::Accessors#element

data/lib/page-object/platforms/watir_webdriver/page_object.rb

@@ -804,7 +804,27 @@ module PageObject
         #
         def file_fields_for(identifier)
           find_watir_elements("file_fields(identifier)", Elements::FileField, identifier)
-          
+        end
+
+        #
+        # platform method to click on an area
+        #
+        def click_area_for(identifier)
+          process_watir_call("area(identifier).click", Elements::Area, identifier, nil, 'area')
+        end
+
+        #
+        # platform method to retrieve an area element
+        #
+        def area_for(identifier)
+          find_watir_element("area(identifier)", Elements::Area, identifier, 'area')
+        end
+
+        #
+        # platform method to retrieve an array of area elements
+        #
+        def areas_for(identifier)
+          find_watir_elements("areas(identifier)", Elements::Area, identifier, 'area')
         end
 
         #

data/lib/page-object/version.rb

@@ -1,4 +1,4 @@
 module PageObject
   # @private
-  VERSION = "0.7.0"
+  VERSION = "0.7.1"
 end

data/spec/page-object/elements/area_spec.rb

@@ -0,0 +1,45 @@
+require 'spec_helper'
+require 'page-object/elements'
+
+describe PageObject::Elements::Area do
+  let(:area) { PageObject::Elements::Area }
+
+  context "when mapping how to find an element" do
+    it "should map watir types to same" do
+      [:class, :id, :index, :name, :xpath].each do |t|
+        identifier = area.watir_identifier_for t => 'value'
+        identifier.keys.first.should == t
+      end
+    end
+
+    it "should map selenium types to same" do
+      [:class, :id, :index, :name, :xpath].each do |t|
+        key, value = area.selenium_identifier_for t => 'value'
+        key.should == t
+      end
+    end
+  end
+
+  context "implementation" do
+    let(:area_element) { double('area_element') }
+
+    context "when using selenium" do
+      let(:selenium_area) { PageObject::Elements::Area.new(area_element, :platform => :selenium_webdriver) }
+      
+      it "should know its coords" do
+        area_element.should_receive(:attribute).with(:coords).and_return("1,2,3,4")
+        selenium_area.coords.should == "1,2,3,4"
+      end
+
+      it "should know its shape" do
+        area_element.should_receive(:attribute).with(:shape).and_return('circle')
+        selenium_area.shape.should == 'circle'
+      end
+
+      it "should know its href" do
+        area_element.should_receive(:attribute).with(:href).and_return('twitter.com')
+        selenium_area.href.should == 'twitter.com'
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: page-object
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.7.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-06-30 00:00:00.000000000 Z
+date: 2012-07-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: watir-webdriver
@@ -125,6 +125,7 @@ files:
 - README.md
 - Rakefile
 - cucumber.yml
+- features/area.feature
 - features/async.feature
 - features/button.feature
 - features/check_box.feature
@@ -154,8 +155,11 @@ files:
 - features/html/nested_frame_2.html
 - features/html/nested_frame_3.html
 - features/html/nested_frames.html
+- features/html/planets.gif
 - features/html/static_elements.html
 - features/html/success.html
+- features/html/sun.gif
+- features/html/sun.html
 - features/image.feature
 - features/indexed_property.feature
 - features/javascript.feature
@@ -177,6 +181,7 @@ files:
 - features/select_list.feature
 - features/span.feature
 - features/step_definitions/accessor_steps.rb
+- features/step_definitions/area_steps.rb
 - features/step_definitions/async_steps.rb
 - features/step_definitions/button_steps.rb
 - features/step_definitions/check_box_steps.rb
@@ -225,6 +230,7 @@ files:
 - lib/page-object/core_ext/string.rb
 - lib/page-object/element_locators.rb
 - lib/page-object/elements.rb
+- lib/page-object/elements/area.rb
 - lib/page-object/elements/button.rb
 - lib/page-object/elements/check_box.rb
 - lib/page-object/elements/div.rb
@@ -295,6 +301,7 @@ files:
 - lib/page-object/version.rb
 - page-object.gemspec
 - spec/page-object/element_locators_spec.rb
+- spec/page-object/elements/area_spec.rb
 - spec/page-object/elements/button_spec.rb
 - spec/page-object/elements/check_box_spec.rb
 - spec/page-object/elements/div_spec.rb
@@ -347,7 +354,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -1451627293781447713
+      hash: -3346417755984147094
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -356,7 +363,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -1451627293781447713
+      hash: -3346417755984147094
 requirements: []
 rubyforge_project: page-object
 rubygems_version: 1.8.24
@@ -364,6 +371,7 @@ signing_key:
 specification_version: 3
 summary: Page Object DSL for browser testing
 test_files:
+- features/area.feature
 - features/async.feature
 - features/button.feature
 - features/check_box.feature
@@ -393,8 +401,11 @@ test_files:
 - features/html/nested_frame_2.html
 - features/html/nested_frame_3.html
 - features/html/nested_frames.html
+- features/html/planets.gif
 - features/html/static_elements.html
 - features/html/success.html
+- features/html/sun.gif
+- features/html/sun.html
 - features/image.feature
 - features/indexed_property.feature
 - features/javascript.feature
@@ -416,6 +427,7 @@ test_files:
 - features/select_list.feature
 - features/span.feature
 - features/step_definitions/accessor_steps.rb
+- features/step_definitions/area_steps.rb
 - features/step_definitions/async_steps.rb
 - features/step_definitions/button_steps.rb
 - features/step_definitions/check_box_steps.rb
@@ -460,6 +472,7 @@ test_files:
 - features/text_field.feature
 - features/unordered_list.feature
 - spec/page-object/element_locators_spec.rb
+- spec/page-object/elements/area_spec.rb
 - spec/page-object/elements/button_spec.rb
 - spec/page-object/elements/check_box_spec.rb
 - spec/page-object/elements/div_spec.rb