watir-nokogiri 1.0.0

data/lib/watir-nokogiri/elements/hidden.rb

@@ -0,0 +1,24 @@
+# encoding: utf-8
+module WatirNokogiri
+  class Hidden < Input
+    def visible?
+      false
+    end
+  end
+
+  module Container
+    def hidden(*args)
+      Hidden.new(self, extract_selector(args).merge(:tag_name => "input", :type => "hidden"))
+    end
+
+    def hiddens(*args)
+      HiddenCollection.new(self, extract_selector(args).merge(:tag_name => "input", :type => "hidden"))
+    end
+  end # Container
+
+  class HiddenCollection < InputCollection
+    def element_class
+      Hidden
+    end
+  end # HiddenCollection
+end # Nokogiri

data/lib/watir-nokogiri/elements/image.rb

@@ -0,0 +1,59 @@
+# encoding: utf-8
+module WatirNokogiri
+  class Image < HTMLElement
+
+    #
+    # Returns true if image is loaded.
+    #
+    # @return [Boolean]
+    #
+
+    def loaded?
+      assert_exists
+      raise NotImplementedError, "not currently supported by WatirNokogiri"
+    end
+
+    #
+    # Returns the image's width in pixels.
+    #
+    # @return [Fixnum] width
+    #
+
+    def width
+      assert_exists
+      raise NotImplementedError, "not currently supported by WatirNokogiri"
+    end
+
+    #
+    # Returns the image's height in pixels.
+    #
+    # @return [Fixnum] width
+    #
+
+    def height
+      assert_exists
+      raise NotImplementedError, "not currently supported by WatirNokogiri"
+    end
+
+    def file_created_date
+      assert_exists
+      raise NotImplementedError, "not currently supported by WatirNokogiri"
+    end
+
+    def file_size
+      assert_exists
+      raise NotImplementedError, "not currently supported by WatirNokogiri"
+    end
+
+    def save(path)
+      assert_exists
+      raise NotImplementedError, "not currently supported by WatirNokogiri"
+    end
+
+  end # Image
+
+  module Container
+     alias_method :image, :img
+     alias_method :images, :imgs
+  end # Container
+end # WatirNokogiri

data/lib/watir-nokogiri/elements/input.rb

@@ -0,0 +1,34 @@
+# encoding: utf-8
+module WatirNokogiri
+  class Input < HTMLElement
+
+    alias_method :readonly?, :read_only?
+
+    #
+    # Returns true if input is enabled.
+    #
+    # @return [Boolean]
+    #
+
+    def enabled?
+      !disabled?
+    end
+
+    #
+    # Return the type attribute of the element, or 'text' if the attribute is invalid.
+    # TODO: discuss.
+    #
+    # @return [String]
+    #
+
+    def type
+      assert_exists
+      value = @element.get_attribute("type").to_s
+
+      # we return 'text' if the type is invalid
+      # not sure if we really should do this
+      TextFieldLocator::NON_TEXT_TYPES.include?(value) ? value : 'text'
+    end
+
+  end # Input
+end # WatirNokogiri

data/lib/watir-nokogiri/elements/link.rb

@@ -0,0 +1,7 @@
+# encoding: utf-8
+module WatirNokogiri
+  module Container
+    alias_method :link,  :a
+    alias_method :links, :as
+  end
+end # WatirNokogiri

data/lib/watir-nokogiri/elements/option.rb

@@ -0,0 +1,83 @@
+# encoding: utf-8
+module WatirNokogiri
+
+  #
+  # Represents an option in a select list.
+  #
+
+  class Option < HTMLElement
+
+    #
+    # Selects this option.
+    #
+    # @example
+    #   browser.select(:id => "foo").options.first.select
+    #
+
+    def select
+      assert_exists
+      raise NotImplementedError, "not currently supported by WatirNokogiri"
+    end
+
+    #
+    # Toggles the selected state of this option.
+    #
+    # @example
+    #   browser.select(:id => "foo").options.first.toggle
+    #
+
+    def toggle
+      assert_exists
+      raise NotImplementedError, "not currently supported by WatirNokogiri"
+    end
+
+    #
+    # Clears (i.e. toggles selected state) option.
+    #
+    # @example
+    #   browser.select(:id => "foo").options.first.clear
+    #
+
+    def clear
+      raise NotImplementedError, "not currently supported by WatirNokogiri"
+    end
+
+    #
+    # Is this option selected?
+    #
+    # @return [Boolean]
+    #
+
+    def selected?
+      assert_exists
+      !@element.get_attribute('selected').nil?
+    end
+
+    #
+    # Returns the text of option.
+    #
+    # Note that the text is either one of the following respectively:
+    #   * label attribute
+    #   * text attribute
+    #   * inner element text
+    #
+    # @return [String]
+    #
+
+    def text
+      assert_exists
+
+      # A little unintuitive - we'll return the 'label' or 'text' attribute if
+      # they exist, otherwise the inner text of the element
+
+      attribute = [:label, :text].find { |a| attribute? a }
+
+      if attribute
+        @element.get_attribute(attribute)
+      else
+        @element.text
+      end
+    end
+
+  end # Option
+end # WatirNokogiri

data/lib/watir-nokogiri/elements/radio.rb

@@ -0,0 +1,44 @@
+# encoding: utf-8
+module WatirNokogiri
+  class Radio < Input
+
+    #
+    # Selects this radio button.
+    #
+
+    def set
+      assert_exists
+      raise NotImplementedError, "not currently supported by WatirNokogiri"
+    end
+
+    #
+    # Is this radio set?
+    #
+    # @return [Boolean]
+    #
+
+    def set?
+      assert_exists
+      !@element.get_attribute('checked').nil?
+    end
+
+  end # Radio
+
+  module Container
+    def radio(*args)
+      Radio.new(self, extract_selector(args).merge(:tag_name => "input", :type => "radio"))
+    end
+
+    def radios(*args)
+      RadioCollection.new(self, extract_selector(args).merge(:tag_name => "input", :type => "radio" ))
+    end
+  end # Container
+
+  class RadioCollection < InputCollection
+    private
+
+    def element_class
+      Radio
+    end
+  end # RadioCollection
+end # WatirNokogiri

data/lib/watir-nokogiri/elements/select.rb

@@ -0,0 +1,126 @@
+# encoding: utf-8
+module WatirNokogiri
+  class Select < HTMLElement
+    include WatirNokogiri::Exception
+
+    #
+    # Returns true if this element is enabled
+    #
+    # @return [Boolean]
+    #
+
+    def enabled?
+      !disabled?
+    end
+
+    #
+    # Clears all selected options.
+    #
+
+    def clear
+      assert_exists
+      raise NotImplementedError, "not currently supported by WatirNokogiri"
+    end
+
+    #
+    # Gets all the options in the select list
+    #
+    # @return [Watir::OptionCollection]
+    #
+
+    def options
+      assert_exists
+      super
+    end
+
+    #
+    # Returns true if the select list has one or more options where text or label matches the given value.
+    #
+    # @param [String, Regexp] str_or_rx
+    # @return [Boolean]
+    #
+
+    def include?(str_or_rx)
+      assert_exists
+      # TODO: optimize similar to selected?
+      options.any? { |e| str_or_rx === e.text }
+    end
+
+    #
+    # Select the option(s) whose text or label matches the given string.
+    # If this is a multi-select and several options match the value given, all will be selected.
+    #
+    # @param [String, Regexp] str_or_rx
+    # @raise [Watir::Exception::NoValueFoundException] if the value does not exist.
+    # @return [String] The text of the option selected. If multiple options match, returns the first match.
+    #
+
+    def select(str_or_rx)
+      assert_exists
+      raise NotImplementedError, "not currently supported by WatirNokogiri"
+    end
+
+    #
+    # Selects the option(s) whose value attribute matches the given string.
+    #
+    # @see +select+
+    #
+    # @param [String, Regexp] str_or_rx
+    # @raise [Watir::Exception::NoValueFoundException] if the value does not exist.
+    # @return [String] The option selected. If multiple options match, returns the first match
+    #
+
+    def select_value(str_or_rx)
+      assert_exists
+      raise NotImplementedError, "not currently supported by WatirNokogiri"
+    end
+
+    #
+    # Returns true if any of the selected options' text or label matches the given value.
+    #
+    # @param [String, Regexp] str_or_rx
+    # @raise [Watir::Exception::UnknownObjectException] if the options do not exist
+    # @return [Boolean]
+    #
+
+    def selected?(str_or_rx)
+      assert_exists
+      matches = options.select { |e| str_or_rx === e.text || str_or_rx === e.attribute_value(:label) }
+
+      if matches.empty?
+        raise UnknownObjectException, "Unable to locate option matching #{str_or_rx.inspect}"
+      end
+
+      matches.any? { |e| e.selected? }
+    end
+
+    #
+    # Returns the value of the first selected option in the select list.
+    # Returns nil if no option is selected.
+    #
+    # @return [String, nil]
+    #
+
+    def value
+      o = options.find { |e| e.selected? } || return
+      o.value
+    end
+
+    #
+    # Returns an array of currently selected options.
+    #
+    # @return [Array<Watir::Option>]
+    #
+
+    def selected_options
+      assert_exists
+      options.select { |e| e.selected? }
+    end
+
+  end # Select
+
+  module Container
+    alias_method :select_list,  :select
+    alias_method :select_lists, :selects
+  end # Container
+end # Watir

data/lib/watir-nokogiri/elements/table.rb

@@ -0,0 +1,44 @@
+# encoding: utf-8
+
+module WatirNokogiri
+  class Table < HTMLElement
+    include RowContainer
+
+    #
+    # Represents table rows as hashes
+    #
+    # @return [Array<Hash>]
+    #
+
+    def hashes
+      all_rows = rows.to_a
+      header_row = all_rows.shift or raise Exception::Error, "no rows in table"
+
+      headers = header_row.ths.map { |header_cell| header_cell.text  }
+      result = []
+
+      all_rows.each_with_index do |row, idx|
+        cells = row.cells.to_a
+        if cells.length != headers.length
+          raise Exception::Error, "row at index #{idx} has #{cells.length} cells, expected #{headers.length}"
+        end
+
+        result << headers.inject({}) { |res, header| res.merge(header => cells.shift.text) }
+      end
+
+      result
+    end
+
+    #
+    # Returns row of this table with given index.
+    #
+    # @param [Fixnum] idx
+    # @return WatirNokogiri::TableRow
+    #
+
+    def [](idx)
+      row(:index, idx)
+    end
+
+  end # Table
+end # WatirNokogiri

data/lib/watir-nokogiri/elements/table_cell.rb

@@ -0,0 +1,36 @@
+module WatirNokogiri
+  class TableCell < HTMLElement
+    # @private
+    attr_writer :locator_class
+
+    def locator_class
+      @locator_class || super
+    end
+
+    def colspan
+      value = attribute_value :colspan
+      value != '' ? Integer(value) : 1
+    end
+  end # TableCell
+
+  class TableCellCollection < ElementCollection
+    attr_writer :locator_class
+
+    def locator_class
+      @locator_class || super
+    end
+
+    def elements
+      # we do this craziness since the xpath used will find direct child rows
+      # before any rows inside thead/tbody/tfoot...
+      elements = super
+
+      if locator_class == ChildCellLocator
+        elements = elements.sort_by { |row| row.get_attribute(:cellIndex).to_i }
+      end
+
+      elements
+    end
+
+  end # TableCellCollection
+end # WatirNokogiri