与页面中的元素交互

获取元素的内容

可以通过 value 属性获取元素的内容:

browser.find_by_css('h1').first.value

or

element = browser.find_by_css('h1').first
element.value

点击链接

你可以通过 href , partial href, text or partial text 来点击链接。 切记: 这些方法永远返回获取到得第一个链接.

browser.click_link_by_href('http://www.the_site.com/my_link')

or

browser.click_link_by_partial_href('my_link')

or

browser.click_link_by_text('my link')

or

browser.click_link_by_partial_text('part of link text')

or

browser.click_link_by_id('link_id')

点击按钮

Splinter 支持点击按钮后的重定向和提交表单。

browser.find_by_name('send').first.click()

or

browser.find_link_by_text('my link').first.click()

表单交互

browser.fill('query', 'my name')
browser.attach_file('file', '/path/to/file/somefile.jpg')
browser.choose('some-radio', 'radio-value')
browser.check('some-check')
browser.uncheck('some-check')
browser.select('uf', 'rj')

你可以使用 type 方法触发按下键或者按上键的 JavaScript 事件。

browser.type('type', 'typing text')

If you pass the argument slowly=True to the type method you can interact with the page on every key pressed. Useful for testing field’s autocompletion (the browser will wait until next iteration to type the subsequent key).

for key in browser.type('type', 'typing slowly', slowly=True):
    pass # make some assertion here with the key object :)

You can also use type and fill methods in an element:

browser.find_by_name('name').type('Steve Jobs', slowly=True)
browser.find_by_css('.city').fill('San Francisco')

检测元素是否可见

使用 visible 属性检测元素是否可见。例如：

browser.find_by_css('h1').first.visible

如果元素可见会返回True，不可见则返回False。

Verifying if element has a className

To check if an element has a className, use the has_class method. For instance:

browser.find_by_css('.content').first.has_class('content')

Interacting with elements through a ElementList object

Don’t you like to always use first when selecting an element for clicking, for example:

browser.find_by_css('a.my-website').first.click()

You can invoke any Element method on ElementList and it will be proxied to the first element of the list. So the two lines below are equivalent:

assert browser.find_by_css('a.banner').first.visible
assert browser.find_by_css('a.banner').visible