Class: Watir::Button

Inherits:
HTMLElement show all
Defined in:
lib/watir-webdriver/elements/button.rb,
lib/watir-webdriver/elements/generated.rb

Overview

Class representing button elements.

This class covers both <button> and <input type="submit|reset|image|button" /> elements.

Constant Summary

VALID_TYPES = 
%w[button reset submit image]

Constants included from AttributeHelper

AttributeHelper::IGNORED_ATTRIBUTES

Constants included from Atoms

Atoms::ATOMS

Instance Method Summary (collapse)

Methods inherited from HTMLElement

#access_key, #access_key_label, #class_name, #command_checked?, #command_disabled?, #command_hidden?, #command_icon, #command_label, #command_type, #content_editable, #content_editable?, #dir, #draggable?, #hidden?, #item_id, #item_scope?, #item_value, #lang, #spellcheck?, #tab_index, #title, #translate?

Methods inherited from Element

#==, #attribute_value, #browser, #click, #double_click, #drag_and_drop_by, #drag_and_drop_on, #driver, #exists?, #fire_event, #flash, #focus, #focused?, #hash, #hover, #html, #id, #initialize, #inspect, #parent, #present?, #right_click, #run_checkers, #select_text, #send_keys, #style, #tag_name, #to_subtype, #visible?, #wd

Methods included from AttributeHelper

#attribute_list, #attributes, #typed_attributes

Methods included from EventuallyPresent

#wait_until_present, #wait_while_present, #when_present

Methods included from Container

#a, #abbr, #abbrs, #address, #addresses, #area, #areas, #article, #articles, #as, #aside, #asides, #audio, #audios, #b, #base, #bases, #bdi, #bdis, #bdo, #bdos, #blockquote, #blockquotes, #body, #bodys, #br, #brs, #bs, #button, #buttons, #canvas, #canvases, #caption, #captions, #checkbox, #checkboxes, #cite, #cites, #code, #codes, #col, #colgroup, #colgroups, #cols, #command, #commands, #data, #datalist, #datalists, #dd, #dds, #del, #dels, #details, #detailses, #dfn, #dfns, #dialog, #dialogs, #div, #divs, #dl, #dls, #dt, #dts, #element, #elements, #em, #embed, #embeds, #ems, #extract_selector, #field_set, #field_sets, #fieldset, #fieldsets, #figcaption, #figcaptions, #figure, #figures, #file_field, #file_fields, #font, #fonts, #footer, #footers, #form, #forms, #frame, #frames, #frameset, #framesets, #h1, #h1s, #h2, #h2s, #h3, #h3s, #h4, #h4s, #h5, #h5s, #h6, #h6s, #head, #header, #headers, #heads, #hgroup, #hgroups, #hidden, #hiddens, #hr, #hrs, #html, #htmls, #i, #iframe, #iframes, #image, #images, #img, #imgs, #input, #inputs, #ins, #inses, #is, #kbd, #kbds, #keygen, #keygens, #label, #labels, #legend, #legends, #li, #link, #links, #lis, #map, #maps, #mark, #marks, #menu, #menus, #meta, #metas, #meter, #meters, #nav, #navs, #noscript, #noscripts, #object, #objects, #ol, #ols, #optgroup, #optgroups, #option, #options, #output, #outputs, #p, #param, #params, #pre, #pres, #progress, #progresses, #ps, #q, #qs, #radio, #radios, #rp, #rps, #rt, #rts, #rubies, #ruby, #s, #samp, #samps, #script, #scripts, #section, #sections, #select, #select_list, #select_lists, #selects, #small, #smalls, #source, #sources, #span, #spans, #ss, #strong, #strongs, #style, #styles, #sub, #subs, #summaries, #summary, #sup, #sups, #table, #tables, #tbody, #tbodys, #td, #tds, #text_field, #text_fields, #textarea, #textareas, #tfoot, #tfoots, #th, #thead, #theads, #ths, #time, #times, #title, #titles, #tr, #track, #tracks, #trs, #u, #ul, #uls, #us, #var, #vars, #video, #videos, #wbr, #wbrs

Methods included from Atoms

load

Methods included from XpathSupport

escape

Constructor Details

This class inherits a constructor from Watir::Element

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class Watir::Element

Instance Method Details

- (Boolean) autofocus?

Returns:

  • (Boolean) 


243
 
# File 'lib/watir-webdriver/elements/generated.rb', line 243

attributes(:bool => [:autofocus, :disabled, :form_no_validate, :will_validate], :html_element => [:form], :string => [:form_action, :form_enctype, :form_method, :form_target, :name, :type, :validation_message, :validity, :value], :list => [:labels])

- (Boolean) disabled?

Returns:

  • (Boolean) 


243
 
# File 'lib/watir-webdriver/elements/generated.rb', line 243

attributes(:bool => [:autofocus, :disabled, :form_no_validate, :will_validate], :html_element => [:form], :string => [:form_action, :form_enctype, :form_method, :form_target, :name, :type, :validation_message, :validity, :value], :list => [:labels])

- (Boolean) enabled?

Returns true if this element is enabled

Returns:

  • (Boolean) 


45
46
47
 
# File 'lib/watir-webdriver/elements/button.rb', line 45

def enabled?
  !disabled?
end

- (String) form_action

Returns:

  • (String) 


243
 
# File 'lib/watir-webdriver/elements/generated.rb', line 243

attributes(:bool => [:autofocus, :disabled, :form_no_validate, :will_validate], :html_element => [:form], :string => [:form_action, :form_enctype, :form_method, :form_target, :name, :type, :validation_message, :validity, :value], :list => [:labels])

- (String) form_enctype

Returns:

  • (String) 


243
 
# File 'lib/watir-webdriver/elements/generated.rb', line 243

attributes(:bool => [:autofocus, :disabled, :form_no_validate, :will_validate], :html_element => [:form], :string => [:form_action, :form_enctype, :form_method, :form_target, :name, :type, :validation_message, :validity, :value], :list => [:labels])

- (String) form_method

Returns:

  • (String) 


243
 
# File 'lib/watir-webdriver/elements/generated.rb', line 243

attributes(:bool => [:autofocus, :disabled, :form_no_validate, :will_validate], :html_element => [:form], :string => [:form_action, :form_enctype, :form_method, :form_target, :name, :type, :validation_message, :validity, :value], :list => [:labels])

- (Boolean) form_no_validate?

Returns:

  • (Boolean) 


243
 
# File 'lib/watir-webdriver/elements/generated.rb', line 243

attributes(:bool => [:autofocus, :disabled, :form_no_validate, :will_validate], :html_element => [:form], :string => [:form_action, :form_enctype, :form_method, :form_target, :name, :type, :validation_message, :validity, :value], :list => [:labels])

- (String) form_target

Returns:

  • (String) 


243
 
# File 'lib/watir-webdriver/elements/generated.rb', line 243

attributes(:bool => [:autofocus, :disabled, :form_no_validate, :will_validate], :html_element => [:form], :string => [:form_action, :form_enctype, :form_method, :form_target, :name, :type, :validation_message, :validity, :value], :list => [:labels])

- (String) name

Returns:

  • (String) 


243
 
# File 'lib/watir-webdriver/elements/generated.rb', line 243

attributes(:bool => [:autofocus, :disabled, :form_no_validate, :will_validate], :html_element => [:form], :string => [:form_action, :form_enctype, :form_method, :form_target, :name, :type, :validation_message, :validity, :value], :list => [:labels])

- (Object) text

Returns the text of the button.

For input elements, returns the "value" attribute. For button elements, returns the inner text.



24
25
26
27
28
29
30
31
32
33
34
35
36
37
 
# File 'lib/watir-webdriver/elements/button.rb', line 24

def text
  assert_exists

  tn = @element.tag_name.downcase

  case tn
  when 'input'
    @element.attribute(:value)
  when 'button'
    @element.text
  else
    raise Exception::Error, "unknown tag name for button: #{tn}"
  end
end

- (String) type

Returns:

  • (String) 


243
 
# File 'lib/watir-webdriver/elements/generated.rb', line 243

attributes(:bool => [:autofocus, :disabled, :form_no_validate, :will_validate], :html_element => [:form], :string => [:form_action, :form_enctype, :form_method, :form_target, :name, :type, :validation_message, :validity, :value], :list => [:labels])

- (String) validation_message

Returns:

  • (String) 


243
 
# File 'lib/watir-webdriver/elements/generated.rb', line 243

attributes(:bool => [:autofocus, :disabled, :form_no_validate, :will_validate], :html_element => [:form], :string => [:form_action, :form_enctype, :form_method, :form_target, :name, :type, :validation_message, :validity, :value], :list => [:labels])

- (String) validity

Returns:

  • (String) 


243
 
# File 'lib/watir-webdriver/elements/generated.rb', line 243

attributes(:bool => [:autofocus, :disabled, :form_no_validate, :will_validate], :html_element => [:form], :string => [:form_action, :form_enctype, :form_method, :form_target, :name, :type, :validation_message, :validity, :value], :list => [:labels])

- (String) value

Returns:

  • (String) 


243
 
# File 'lib/watir-webdriver/elements/generated.rb', line 243

attributes(:bool => [:autofocus, :disabled, :form_no_validate, :will_validate], :html_element => [:form], :string => [:form_action, :form_enctype, :form_method, :form_target, :name, :type, :validation_message, :validity, :value], :list => [:labels])

- (Boolean) will_validate?

Returns:

  • (Boolean) 


243
 
# File 'lib/watir-webdriver/elements/generated.rb', line 243

attributes(:bool => [:autofocus, :disabled, :form_no_validate, :will_validate], :html_element => [:form], :string => [:form_action, :form_enctype, :form_method, :form_target, :name, :type, :validation_message, :validity, :value], :list => [:labels])