From 46afbc767f9241098564ba91c9bc0005d40975ae Mon Sep 17 00:00:00 2001 From: g1879 Date: Tue, 13 Apr 2021 17:51:23 +0800 Subject: [PATCH] =?UTF-8?q?1.10.0=20=E6=9C=AA=E5=AE=8C=E6=88=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.en.md | 41 ++++++++++++++++++++++++----------------- README.zh-cn.md | 25 +++++++++++++++++++++++-- 2 files changed, 47 insertions(+), 19 deletions(-) diff --git a/README.en.md b/README.en.md index a0a1e80..a8f63fa 100644 --- a/README.en.md +++ b/README.en.md @@ -591,7 +591,7 @@ page.to_frame(iframe) # cut into iframe page.screenshot(path) # Page screenshot page.scrool_to_see(element) # Scroll until an element is visible page.scroll_to(mode, - pixel) # Scroll the page as indicated by the parameter, and the scroll direction is optional:'top','bottom','rightmost','leftmost','up','down','left', ' right' + pixel) # Scroll the page as indicated by the parameter, and the scroll direction is optional:'top', 'bottom', 'rightmost', 'leftmost', 'up', 'down', 'left', ' right', 'half' page.refresh() # refresh the current page page.back() # Browser back page.et_window_size(x, y) # Set the browser window size, maximize by default @@ -743,12 +743,29 @@ element.run_script(js, *args) # Run JavaScript script on the element element.submit() # Submit element.clear() # Clear the element element.screenshot(path, filename) # Take a screenshot of the element -element.select(text) # Select the drop- down list based on the text element.set_attr(attr, value) # Set element attribute value element.remove_attr(attr) # remove a element attribute element.drag(x, y, speed, shake) # Drag the relative distance of the element, you can set the speed and whether to shake randomly element.drag_to(ele_or_loc, speed, shake) # Drag the element to another element or a certain coordinate, you can set the speed and whether to shake randomly element.hover() # Hover the mouse over the element + +# select function: +element.select.is_multi # Whether to select multiple lists +element.select.options # Return all list item objects +element.select.selected_option # Return the first selected option element +element.select.selected_options # Return a list of all selected option elements + +element.select(text) # Select the drop-down list item based on the text +element.select(value,'value') # Select the drop-down list item according to the value +element.select(index,'index') # Select the drop-down list item according to the serial number + +element.select.deselect(text) # Deselect drop-down list items based on the text (valid for multiple selection lists) +element.select.deselect(value,'value') # Deselect drop-down list items according to value (valid for multiple selection lists) +element.select.deselect(index,'index') # Deselect drop-down list items according to the serial number (valid for multiple selection lists) +# Note: When the list is a multi-selection list, the first parameter above can receive list or tuple, and select or deselect multiple items at the same time + +element.select.clear() # Clear multiple selection list options +element.select.invert() # Invert multiple selection list options ``` @@ -1997,15 +2014,17 @@ Returns the content of the ::before pseudo- element of the current element Returns: str - - ### after Returns the content of the ::after pseudo element of the current element Returns: str +#### select +If it is a select element, it returns the Select object, otherwise it returns None. + +Returns: Union[Select, None] ### texts() @@ -2013,7 +2032,7 @@ Returns the text of all direct child nodes within the element, including element Parameter Description: -- text_node_only: bool - whether to return only text nodes +- text_node_only: bool - whether to return only text nodes Returns: List[str] @@ -2267,18 +2286,6 @@ Returns: str -### select() - -Select from the drop- down list. - -Parameter Description: - -- text: str - option text - -Returns: bool - success - - - ### set_attr() Set element attributes. diff --git a/README.zh-cn.md b/README.zh-cn.md index 8ed6283..0208297 100644 --- a/README.zh-cn.md +++ b/README.zh-cn.md @@ -454,6 +454,9 @@ proxy = {'http': '127.0.0.1:1080', 'https': '127.0.0.1:1080'} # 传入配置，driver_or_options 和 session_or_options 都是可选的，须要使用对应模式才须要传入 drission = Drission(driver_or_options, session_or_options, proxy=proxy) + +# 关闭浏览器，debug 模式下须要显式调用这句，浏览器才能关掉 +drission.kill_browser() ``` DriverOptions 和 SessionOptions 用法详见下文。 @@ -555,7 +558,7 @@ page.to_frame(iframe) # 切入 iframe page.screenshot(path) # 页面截图 page.scroll_to_see(element) # 滚动直到某元素可见 page.scroll_to(mode, - pixel) # 按参数指示方式滚动页面，可选滚动方向：'top', 'bottom', 'rightmost', 'leftmost', 'up', 'down', 'left', 'right' + pixel) # 按参数指示方式滚动页面，可选滚动方向：'top', 'bottom', 'rightmost', 'leftmost', 'up', 'down', 'left', 'right', 'half' page.refresh() # 刷新当前页面 page.back() # 浏览器后退 page.et_window_size(x, y) # 设置浏览器窗口大小，默认最大化 @@ -708,12 +711,30 @@ element.run_script(js, *args) # 对元素运行 JavaScript 脚本 element.submit() # 提交 element.clear() # 清空元素 element.screenshot(path, filename) # 对元素截图 -element.select(text) # 根据文本选择下拉列表 element.set_attr(attr, value) # 设置元素属性值 element.remove_attr(attr) # 删除属性 element.drag(x, y, speed, shake) # 拖动元素相对距离，可设置速度和是否随机抖动 element.drag_to(ele_or_loc, speed, shake) # 拖动元素到另一个元素或某个坐标，可设置速度和是否随机抖动 element.hover() # 在元素上悬停鼠标 + +# select 功能： +element.select.is_multi # 是否多选列表 +element.select.options # 返回所有列表项对象 +element.select.selected_option # 返回第一个被选中的 option 元素 +element.select.selected_options # 返回所有被选中的 option 元素列表 + +element.select(text) # 根据文本选择下拉列表项 +element.select(value, 'value') # 根据 value 选择下拉列表项 +element.select(index, 'index') # 根据序号选择下拉列表项 + +# 多选列表功能： +element.select.deselect(text) # 根据文本取消选择下拉列表项（多选列表时有效） +element.select.deselect(value, 'value') # 根据 value 取消选择下拉列表项（多选列表时有效） +element.select.deselect(index, 'index') # 根据序号取消选择下拉列表项（多选列表时有效） +# 注：当列表为多选列表时，以上的第一个参数可以接收 list 或 tuple，同时选择或取消选择多个项 + +element.select.clear() # 清空多选列表选项 +element.select.invert() # 反选多选列表选项 ```