Method: PageObject::Accessors#button

Defined in:

lib/page-object/accessors.rb

#button(name, identifier = {:index => 0}, &block) ⇒ Object

adds three methods - one to click a button, another to return the button element, and another to check the button’s existence.

Examples:

button(:purchase, :id => 'purchase')
# will generate 'purchase', 'purchase_element', and 'purchase?' methods

Parameters:

• the (Symbol) —

  name used for the generated methods

• identifier (Hash) (defaults to: {:index => 0}) —

  how we find a button. You can use a multiple parameters by combining of any of the following except xpath. The valid keys are:

  • :class => Watir and Selenium

  • :css => Watir and Selenium

  • :id => Watir and Selenium

  • :index => Watir and Selenium

  • :name => Watir and Selenium

  • :text => Watir only

  • :value => Watir and Selenium

  • :xpath => Watir and Selenium

  • :src => Watir and Selenium (input type=image only)

  • :alt => Watir and Selenium (input type=image only)

• optional —

  block to be invoked when element method is called

# File 'lib/page-object/accessors.rb', line 514

def button(name, identifier={:index => 0}, &block)
  standard_methods(name, identifier, 'button_for', &block)
  define_method(name) do
    return platform.click_button_for identifier.clone unless block_given?
    self.send("#{name}_element").click
  end
end