From 29befdfaacebed6c3645c9e38256ae40438c8a01 Mon Sep 17 00:00:00 2001 From: g1879 Date: Mon, 8 Jun 2020 15:00:42 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0README?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.en.md | 15 ++++++++++----- README.zh-cn.md | 16 ++++++++++++---- 2 files changed, 22 insertions(+), 9 deletions(-) diff --git a/README.en.md b/README.en.md index 03fdaf6..2dea5ad 100644 --- a/README.en.md +++ b/README.en.md @@ -292,15 +292,16 @@ Tips：Calling a method that belongs only to the driver mode will automatically ## Find elements -There are many ways to find page elements (eles function will return a list of all the element objects that meet the requirements). +ele() returns the first eligible element, eles() returns a list of all eligible elements. +You can use these two functions under the page object or element object to find the subordinate elements. Note: The element search timeout is 10 seconds by default, you can also set it as required. ```python # Find by attribute page.ele('@id:ele_id', timeout = 2) # Find the element with id ele_id and set the waiting time to 2 seconds -page.eles('@class:class_name') # Find all elements with class class_name -page.eles('@class') # Find all elements with class attribute +page.eles('@class') # Find all elements with ele_class +page.eles('@class:class_name') # Find all elements with class equal to ele_class # Search by tag name page.ele('tag:li') # Find the first li element @@ -308,11 +309,15 @@ page.eles('tag:li') # Find all li elements # Search by tag name and attributes page.ele('tag:div@class=div_class') # Find the first div element whose class is div_class -page.eles('tag:div@class') # Find all div elements with class attribute +page.ele('tag:div@class:ele_class') # Find the div element with ele_class in class +page.ele('tag:div@class=ele_class') # Find div elements with class equal to ele_class +page.ele('tag:div@text():search_text') # Find the div element whose text contains search_text +page.ele('tag:div@text()=search_text') # Find div elements with text equal to search_text # Find by text page.ele('search text') # Find elements containing incoming text -page.eles('text:search text') # If the text starts with @, tag :, css :, xpath :, text :, add text: in front to avoid conflicts. +page.eles('text:search text') # If the text starts with @, tag :, css :, xpath :, text :, add text: in front to avoid conflicts +page.eles('text=search text') # Elements with text equal to search_text # Find by xpath or css selector page.eles('xpath://div[@class="ele_class"]') diff --git a/README.zh-cn.md b/README.zh-cn.md index cef5aa6..420aff1 100644 --- a/README.zh-cn.md +++ b/README.zh-cn.md @@ -285,15 +285,19 @@ Tips：调用只属于driver模式的方法，会自动切换到driver模式。 ## 查找元素 -可使用多种方法查找页面元素（eles函数会返回所有符合要求的元素对象列表）。 +ele()返回第一个符合条件的元素，eles()返回所有符合条件的元素列表。 +你可在页面对象或元素对象下使用这两个函数，以查找下级元素。 + +page.eles()和element.eles()查找返回符合条件的所有元素列表。 注：元素查找超时默认为10秒，你也可以按需要设置。 ```python # 根据属性查找 -page.ele('@id:ele_id', timeout = 2) # 查找id为ele_id的元素，设置等待时间2秒 -page.eles('@class:class_name') # 查找所有class为class_name的元素 +page.ele('@id:ele_id', timeout = 2) # 查找id为ele_id的元素，设置等待时间2秒 page.eles('@class') # 查找所有拥有class属性的元素 +page.eles('@class:class_name') # 查找所有class含有ele_class的元素 +page.eles('@class=class_name') # 查找所有class等于ele_class的元素 # 根据tag name查找 page.ele('tag:li') # 查找第一个li元素 @@ -301,11 +305,15 @@ page.eles('tag:li') # 查找所有li元素 # 根据tag name及属性查找 page.ele('tag:div@class=div_class') # 查找class为div_class的div元素 -page.eles('tag:div@class') # 查找所有拥有class属性的div元素 +page.ele('tag:div@class:ele_class') # 查找class含有ele_class的div元素 +page.ele('tag:div@class=ele_class') # 查找class等于ele_class的div元素 +page.ele('tag:div@text():search_text') # 查找文本含有search_text的div元素 +page.ele('tag:div@text()=search_text') # 查找文本等于search_text的div元素 # 根据文本内容查找 page.ele('search text') # 查找包含传入文本的元素 page.eles('text:search text') # 如文本以@、tag:、css:、xpath:、text:开头，则在前面加上text:避免冲突 +page.eles('text=search text') # 文本等于search_text的元素 # 根据xpath或css selector查找 page.eles('xpath://div[@class="ele_class"]')