Contents

# encoding: utf-8
module Watir
  class ElementCollection
    include Enumerable

    def initialize(parent, element_class)
      @parent, @element_class = parent, element_class
    end

    #
    # @yieldparam [Watir::BaseElement] element Iterate through the elements in this collection.
    #

    def each(&blk)
      to_a.each(&blk)
    end

    #
    # @return [Fixnum] The number of elements in this collection.
    #

    def length
      elements.length
    end
    alias_method :size, :length

    #
    # Get the element at the given index.
    # Note that this is 0-indexed and not compatible with older Watir implementations.
    #
    # Also note that because of Watir's lazy loading, this will return an Element
    # instance even if the index is out of bounds.
    #
    # @param [Fixnum] n Index of wanted element, 0-indexed
    # @return [Watir::BaseElement] Returns an instance of a Watir::BaseElement subclass
    #


    def [](idx)
      to_a[idx] || @element_class.new(@parent, :index, idx)
    end

    #
    # First element of this collection
    #
    # @return [Watir::BaseElement] Returns an instance of a Watir::BaseElement subclass
    #

    def first
      to_a[0] || @element_class.new(@parent, :index, 0)
    end

    #
    # Last element of the collection
    #
    # @return [Watir::BaseElement] Returns an instance of a Watir::BaseElement subclass
    #

    def last
      to_a[-1] || @element_class.new(@parent, :index, -1)
    end

    #
    # This collection as an Array
    #
    # @return [Array<Watir::BaseElement>]
    #

    def to_a
      # TODO: optimize - lazily @element_class instance
      @to_a ||= elements.map { |e| @element_class.new(@parent, :element, e) }
    end

    private

    def elements
      @elements ||= ElementLocator.new(
        @parent.wd,
        @element_class.default_selector,
        @element_class.attribute_list
      ).locate_all
    end

  end # ElementCollection
end # Watir

Version data entries

9 entries across 9 versions & 1 rubygems

Version	Path
watir-webdriver-0.0.6	lib/watir-webdriver/collections/element_collection.rb
watir-webdriver-0.0.5	lib/watir-webdriver/collections/element_collection.rb
watir-webdriver-0.0.4	lib/watir-webdriver/collections/element_collection.rb
watir-webdriver-0.0.3	lib/watir-webdriver/collections/element_collection.rb
watir-webdriver-0.0.2	lib/watir-webdriver/collections/element_collection.rb
watir-webdriver-0.0.1	lib/watir-webdriver/collections/element_collection.rb
watir-webdriver-0.0.1.dev7	lib/watir-webdriver/collections/element_collection.rb
watir-webdriver-0.0.1.dev6	lib/watir-webdriver/collections/element_collection.rb
watir-webdriver-0.0.1.dev5	lib/watir-webdriver/collections/element_collection.rb