1.10.0 未完成

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.

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()  # 反选多选列表选项
 ```