Class: Watir::Option

Inherits:

HTMLElement

• Object
• Element
• HTMLElement
• Watir::Option

Defined in:

lib/watir-webdriver/elements/option.rb,
lib/watir-webdriver/elements/html_elements.rb

Overview

Represents an option in a select list.

Constant Summary

Constants included from Atoms

Atoms::ATOMS

Instance Method Summary

• #clear ⇒ Object

  Clears (i.e. toggles selected state) option.

• #default_selected? ⇒ Boolean

  Value of defaultSelected property.

• #disabled? ⇒ Boolean

  Value of disabled property.

• #form ⇒ String

  Value of form property.

• #index ⇒ Fixnum

  Value of index property.

• #label ⇒ String

  Value of label property.

• #selected? ⇒ Boolean

  Value of selected property.

• #text ⇒ String

  Returns the text of option.

• #value ⇒ String

  Value of value property.

Methods inherited from HTMLElement

#access_key, #access_key_label, #command_checked?, #command_disabled?, #command_hidden?, #command_icon, #command_label, #command_type, #content_editable, #content_editable?, #context_menu, #dataset, #dir, #draggable?, #dropzone, #hidden?, #item_id, #item_prop, #item_ref, #item_scope?, #item_type, #item_value, #lang, #onabort, #onautocomplete, #onautocompleteerror, #onblur, #oncancel, #oncanplay, #oncanplaythrough, #onchange, #onclick, #onclose, #oncontextmenu, #oncuechange, #ondblclick, #ondrag, #ondragend, #ondragenter, #ondragexit, #ondragleave, #ondragover, #ondragstart, #ondrop, #ondurationchange, #onemptied, #onended, #onerror, #onfocus, #oninput, #oninvalid, #onkeydown, #onkeypress, #onkeyup, #onload, #onloadeddata, #onloadedmetadata, #onloadstart, #onmousedown, #onmouseenter, #onmouseleave, #onmousemove, #onmouseout, #onmouseover, #onmouseup, #onmousewheel, #onpause, #onplay, #onplaying, #onprogress, #onratechange, #onreset, #onresize, #onscroll, #onseeked, #onseeking, #onselect, #onshow, #onsort, #onstalled, #onsubmit, #onsuspend, #ontimeupdate, #ontoggle, #onvolumechange, #onwaiting, #properties, #spellcheck?, #tab_index, #title, #translate?

Methods inherited from Element

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

Methods included from AttributeHelper

#attribute, #attribute_list, #inherit_attributes_from, #method, #typed_attributes

Methods included from EventuallyPresent

#wait_until_present, #wait_while_present, #when_enabled, #when_present

Methods included from Container

#a, #abbr, #abbrs, #address, #addresses, #animate, #animate_motion, #animate_motions, #animate_transform, #animate_transforms, #animates, #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, #circle, #circles, #cite, #cites, #code, #codes, #col, #colgroup, #colgroups, #cols, #cursor, #cursors, #data, #datalist, #datalists, #datas, #dd, #dds, #defs, #defss, #del, #dels, #desc, #descs, #details, #detailses, #dfn, #dfns, #dialog, #dialogs, #discard, #discards, #div, #divs, #dl, #dls, #dt, #dts, #element, #elements, #ellipse, #ellipses, #em, #embed, #embeds, #ems, #extract_selector, #field_set, #field_sets, #fieldset, #fieldsets, #figcaption, #figcaptions, #figure, #figures, #file_field, #file_fields, #font, #fonts, #footer, #footers, #foreign_object, #foreign_objects, #forms, #frame, #frames, #frameset, #framesets, #g, #gs, #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, #labels, #legend, #legends, #li, #line, #linear_gradient, #linear_gradients, #lines, #link, #links, #lis, #main, #mains, #map, #maps, #mark, #marker, #markers, #marks, #menu, #menuitem, #menuitems, #menus, #mesh_gradient, #mesh_gradients, #mesh_patch, #mesh_patches, #mesh_row, #mesh_rows, #meta, #metadata, #metadatas, #metas, #meter, #meters, #mpath, #mpaths, #nav, #navs, #noscript, #noscripts, #object, #objects, #ol, #ols, #optgroup, #optgroups, #option, #options, #output, #outputs, #p, #param, #params, #path, #paths, #pattern, #patterns, #polygon, #polygons, #polyline, #polylines, #pre, #pres, #progress, #progresses, #ps, #q, #qs, #radial_gradient, #radial_gradients, #radio, #radios, #rect, #rects, #rp, #rps, #rt, #rts, #rubies, #ruby, #s, #samp, #samps, #script, #scripts, #section, #sections, #select_list, #select_lists, #selects, #set, #sets, #small, #smalls, #source, #sources, #span, #spans, #ss, #stop, #stops, #strong, #strongs, #style, #styles, #sub, #subs, #summaries, #summary, #sup, #sups, #svg, #svgs, #switch, #switches, #symbol, #symbols, #table, #tables, #tbody, #tbodys, #td, #tds, #template, #templates, #text_field, #text_fields, #text_path, #text_paths, #textarea, #textareas, #tfoot, #tfoots, #th, #thead, #theads, #ths, #time, #times, #title, #titles, #tr, #track, #tracks, #trs, #tspan, #tspans, #u, #ul, #uls, #us, #use, #uses, #var, #vars, #video, #videos, #view, #views, #wbr, #wbrs

Methods included from Atoms

load

Methods included from XpathSupport

downcase, 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

#clear ⇒ Object

Clears (i.e. toggles selected state) option.

Examples:

browser.select(id: "foo").options.first.clear

# File 'lib/watir-webdriver/elements/option.rb', line 34

def clear
  click if selected?
end

#default_selected? ⇒ Boolean

Returns value of defaultSelected property.

Returns:

• (Boolean) —

  value of defaultSelected property

# File 'lib/watir-webdriver/elements/html_elements.rb', line 332

attribute("Boolean", :default_selected?, :defaultSelected)

#disabled? ⇒ Boolean

Returns value of disabled property.

Returns:

• (Boolean) —

  value of disabled property

# File 'lib/watir-webdriver/elements/html_elements.rb', line 329

attribute("Boolean", :disabled?, :disabled)

#form ⇒ String

Returns value of form property.

Returns:

• (String) —

  value of form property

# File 'lib/watir-webdriver/elements/html_elements.rb', line 330

attribute(String, :form, :form)

#index ⇒ Fixnum

Returns value of index property.

Returns:

• (Fixnum) —

  value of index property

# File 'lib/watir-webdriver/elements/html_elements.rb', line 335

attribute(Fixnum, :index, :index)

#label ⇒ String

Returns value of label property.

Returns:

• (String) —

  value of label property

# File 'lib/watir-webdriver/elements/html_elements.rb', line 331

attribute(String, :label, :label)

#selected? ⇒ Boolean

Returns value of selected property.

Returns:

• (Boolean) —

  value of selected property

# File 'lib/watir-webdriver/elements/option.rb', line 44

def selected?
  assert_exists
  element_call { @element.selected? }
end

#text ⇒ String

Returns the text of option.

Note that the text is either one of the following respectively:

* label attribute
* text attribute
* inner element text

Returns:

• (String)

# File 'lib/watir-webdriver/elements/option.rb', line 60

def text
  # 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
    attribute_value(attribute)
  else
    super
  end
end

#value ⇒ String

Returns value of value property.

Returns:

• (String) —

  value of value property

# File 'lib/watir-webdriver/elements/html_elements.rb', line 334

attribute(String, :value, :value)