Splinter入门（三） Finding Elements 查找元素

查找Elements

 Splinter提供了六种查找html元素的API，包括css, xpath, tag, name, id, value, text：

browser.find_by_css('h1')                    
browser.find_by_xpath('//h1')               
browser.find_by_tag('h1')
browser.find_by_name('name')
browser.find_by_text('Hello World!')
browser.find_by_id('firstheader')
browser.find_by_value('query')

获取Elements

 这些方法中的每一个都返回一个包含查找元素的列表。获取列表的元素可以使用：

first_found = browser.find_by_name('name').first # 第一个节点
last_found = browser.find_by_name('name').last   # 最后一个节点
second_found = browser.find_by_name('name')[1]   # 获取索引为1的节点

find_by_id使用注意事项

 网页的每个元素只有一个唯一id，所以find_by_id方法总是返回一个只有一个元素的列表。

Finding links

 有时候，可能只关注含有连接links的元素，因此，在Splinter中，提供了links 命名空间，其下有多个方法可以查找元素。

links_found = browser.links.find_by_text('Link for Example.com')   # 通过Text查找（全匹配）（这里的text指的是a标签内的Text）
links_found = browser.links.find_by_partial_text('for Example')    # 通过Text查找（部分匹配）（这里的text指的是a标签内的Text）
links_found = browser.links.find_by_href('http://example.com')     # 通过链接查找（全匹配）
links_found = browser.links.find_by_partial_href('example')        # 通过链接查找（部分匹配）

links_found = browser.find_by_css('.main').links.find_by_text('Link for Example.com')
links_found = browser.find_by_css('.main').links.find_by_partial_text('for Example.com')
links_found = browser.find_by_css('.main').links.find_by_href('http://example.com')
links_found = browser.find_by_css('.main').links.find_by_partial_href('example')

 以上的find_*方法均返回一个列表。可以看出，links适用适用于browser对象以及elements。

链式查找Elements

 Splinter支持链式查找元素：

divs = browser.find_by_tag("div")                        # 找到所有div
within_elements = divs.first.find_by_name("name")        # 获取第一个div下的name为“name”的元素

元素不存在异常 ElementDoesNotExist exception

 如果找不到一个元素，那么find_*方法将返回一个空列表。但是，如果试图访问此列表中的一个元素，则该方法将引发plinter.Exctions.ElementDoesNotExist异常。