Class: Capybara::Node::Element
- Defined in:
- lib/capybara/node/element.rb
Overview
A Element represents a single element on the page. It is possible to interact with the contents of this element the same as with a document:
session = Capybara::Session.new(:rack_test, my_app)
= session.find('#bar') # from Capybara::Node::Finders
.select('Baz', :from => 'Quox') # from Capybara::Node::Actions
Element also has access to HTML attributes and other properties of the element:
.value
.text
[:title]
Instance Attribute Summary
Attributes inherited from Base
Instance Method Summary collapse
-
#[](attribute) ⇒ String
Retrieve the given attribute.
- #allow_reload! ⇒ Object
-
#checked? ⇒ Boolean
Whether or not the element is checked.
-
#click ⇒ Object
Click the Element.
-
#drag_to(node) ⇒ Object
Drag the element to the given other element.
-
#initialize(session, base, parent, query) ⇒ Element
constructor
A new instance of Element.
- #inspect ⇒ Object
-
#native ⇒ Object
The native element from the driver, this allows access to driver specific methods.
-
#path ⇒ String
An XPath expression describing where on the page the element can be found.
- #reload ⇒ Object
-
#select_option ⇒ Object
Select this node if is an option element inside a select tag.
-
#selected? ⇒ Boolean
Whether or not the element is selected.
-
#set(value) ⇒ Object
Set the value of the form element to the given value.
-
#tag_name ⇒ String
The tag name of the element.
-
#text ⇒ String
The text of the element.
-
#trigger(event) ⇒ Object
Trigger any event on the current element, for example mouseover or focus events.
-
#unselect_option ⇒ Object
Unselect this node if is an option element inside a multiple select tag.
-
#value ⇒ String
The value of the form element.
-
#visible? ⇒ Boolean
Whether or not the element is visible.
Methods inherited from Base
Methods included from Matchers
#==, #assert_no_selector, #assert_selector, #has_button?, #has_checked_field?, #has_css?, #has_field?, #has_link?, #has_no_button?, #has_no_checked_field?, #has_no_css?, #has_no_field?, #has_no_link?, #has_no_select?, #has_no_selector?, #has_no_table?, #has_no_text?, #has_no_unchecked_field?, #has_no_xpath?, #has_select?, #has_selector?, #has_table?, #has_text?, #has_unchecked_field?, #has_xpath?
Methods included from Actions
#attach_file, #check, #choose, #click_button, #click_link, #click_link_or_button, #fill_in, #select, #uncheck, #unselect
Methods included from Finders
#all, #find, #find_button, #find_by_id, #find_field, #find_link, #first
Constructor Details
#initialize(session, base, parent, query) ⇒ Element
Returns a new instance of Element.
25 26 27 28 29 |
# File 'lib/capybara/node/element.rb', line 25 def initialize(session, base, parent, query) super(session, base) @parent = parent @query = query end |
Instance Method Details
#[](attribute) ⇒ String
Retrieve the given attribute
element[:title] # => HTML title attribute
60 61 62 |
# File 'lib/capybara/node/element.rb', line 60 def [](attribute) synchronize { base[attribute] } end |
#allow_reload! ⇒ Object
31 32 33 |
# File 'lib/capybara/node/element.rb', line 31 def allow_reload! @allow_reload = true end |
#checked? ⇒ Boolean
Whether or not the element is checked.
131 132 133 |
# File 'lib/capybara/node/element.rb', line 131 def checked? synchronize { base.checked? } end |
#click ⇒ Object
Click the Element
102 103 104 |
# File 'lib/capybara/node/element.rb', line 102 def click synchronize { base.click } end |
#drag_to(node) ⇒ Object
Drag the element to the given other element.
source = page.find('#foo')
target = page.find('#bar')
source.drag_to(target)
176 177 178 |
# File 'lib/capybara/node/element.rb', line 176 def drag_to(node) synchronize { base.drag_to(node.base) } end |
#inspect ⇒ Object
188 189 190 191 192 |
# File 'lib/capybara/node/element.rb', line 188 def inspect %(#<Capybara::Element tag="#{tag_name}" path="#{path}">) rescue NotSupportedByDriverError %(#<Capybara::Element tag="#{tag_name}">) end |
#native ⇒ Object
Returns The native element from the driver, this allows access to driver specific methods.
39 40 41 |
# File 'lib/capybara/node/element.rb', line 39 def native synchronize { base.native } end |
#path ⇒ String
An XPath expression describing where on the page the element can be found
151 152 153 |
# File 'lib/capybara/node/element.rb', line 151 def path synchronize { base.path } end |
#reload ⇒ Object
180 181 182 183 184 185 186 |
# File 'lib/capybara/node/element.rb', line 180 def reload if @allow_reload reloaded = parent.reload.first(@query.name, @query.locator, @query.) @base = reloaded.base if reloaded end self end |
#select_option ⇒ Object
Select this node if is an option element inside a select tag
86 87 88 |
# File 'lib/capybara/node/element.rb', line 86 def select_option synchronize { base.select_option } end |
#selected? ⇒ Boolean
Whether or not the element is selected.
141 142 143 |
# File 'lib/capybara/node/element.rb', line 141 def selected? synchronize { base.selected? } end |
#set(value) ⇒ Object
Set the value of the form element to the given value.
78 79 80 |
# File 'lib/capybara/node/element.rb', line 78 def set(value) synchronize { base.set(value) } end |
#tag_name ⇒ String
Returns The tag name of the element.
110 111 112 |
# File 'lib/capybara/node/element.rb', line 110 def tag_name synchronize { base.tag_name } end |
#text ⇒ String
Returns The text of the element.
47 48 49 |
# File 'lib/capybara/node/element.rb', line 47 def text synchronize { base.text } end |
#trigger(event) ⇒ Object
Trigger any event on the current element, for example mouseover or focus events. Does not work in Selenium.
162 163 164 |
# File 'lib/capybara/node/element.rb', line 162 def trigger(event) synchronize { base.trigger(event) } end |
#unselect_option ⇒ Object
Unselect this node if is an option element inside a multiple select tag
94 95 96 |
# File 'lib/capybara/node/element.rb', line 94 def unselect_option synchronize { base.unselect_option } end |
#value ⇒ String
Returns The value of the form element.
68 69 70 |
# File 'lib/capybara/node/element.rb', line 68 def value synchronize { base.value } end |
#visible? ⇒ Boolean
Whether or not the element is visible. Not all drivers support CSS, so the result may be inaccurate.
121 122 123 |
# File 'lib/capybara/node/element.rb', line 121 def visible? synchronize { base.visible? } end |