修改文档

This commit is contained in:
g1879 2022-01-18 17:10:42 +08:00
parent 01834e32c8
commit dc01451c05
8 changed files with 32 additions and 28 deletions

View File

@ -14,8 +14,7 @@ page.get_cookies(all_domains=True)
page.set_cookies(cookies)
```
**Tips:**
- d 模式设置`cookies`后要刷新页面才能看到效果。
- s 模式可在 ini 文件、`SessionOptions`、配置字典中设置`cookies`,在`MixPage`初始化时即可传入d 模式只能用`set_cookies()`函数设置。
?> **Tips:** <br>
d 模式设置`cookies`后要刷新页面才能看到效果。 <br>
s 模式可在 ini 文件、`SessionOptions`、配置字典中设置`cookies`,在`MixPage`初始化时即可传入d 模式只能用`set_cookies()`函数设置。

View File

@ -1,12 +1,12 @@
本库使用 ini 文件记录浏览器或`Session`对象的启动配置。便于配置复用,免于在代码中加入繁琐的配置信息。
默认情况下,`MixPage`对象启动时自动加载文件中的配置信息。
也可以在默认配置基础上用简单的方法再次修改,再保存到 ini 文件。
也可以保存多个 ini 文件,按不同项目须要调用。
**注意:**
也可以保存多个 ini 文件,按不同项目须要调用。
- ini 文件仅用于管理启动配置,浏览器或`Session`创建后再修改 ini 文件内容是没有效果的。
- 如果是接管已打开的浏览器,这些设置也没有用。
- 每次升级本库ini 文件都会被重置,可另存到其它路径以免重置。
!> **注意:** <br>
ini 文件仅用于管理启动配置,浏览器或`Session`创建后再修改 ini 文件内容是没有效果的。 <br>
如果是接管已打开的浏览器,这些设置也没有用。 <br>
每次升级本库ini 文件都会被重置,可另存到其它路径以免重置。
# ini 文件内容
@ -127,11 +127,11 @@ do.save(r'D:\config1.ini')
# easy_set 方法
Chrome 浏览器的配置繁琐且难以记忆,本库提供一些常用功能的快速设置方法,调用即可修改 ini 文件中该部分内容。
**注意:**
Chrome 浏览器的配置繁琐且难以记忆,本库提供一些常用功能的快速设置方法,调用即可修改 ini 文件中该部分内容。
- easy_set 方法仅用于设置 ini 文件,浏览器或 Session 创建后再调用没有效果的。
- 如果是接管已打开的浏览器,这些设置也没有用。
!> **注意:** <br>
easy_set 方法仅用于设置 ini 文件,浏览器或 Session 创建后再调用没有效果的。 <br>
如果是接管已打开的浏览器,这些设置也没有用。
## 简单示例

View File

@ -23,7 +23,9 @@ so = SessionOptions(read_file=False)
page = MixPage(driver_options=do, session_options=so)
```
**注意** ,这个时候`Drission`的两个参数都要输入内容,如果其中一个不需要设置可以输入`False`,如:
!> **注意** ,这个时候`Drission`的两个参数都要输入内容,如果其中一个不需要设置可以输入`False`.
如:
```python
drission = Drission(driver_or_options=do, session_or_options=False)

View File

@ -383,7 +383,8 @@ ele2 = ele1.ele('tag:div@text():text')
ele2 = ele1.ele('tag:div@@text():text')
```
**Tips:** 注意, `tag:div@text():text``tag:div@@text():text` 是有区别的,前者只在`div`的直接文本节点搜索,后者搜索`div`的整个内部。
?> **Tips:** <br>
注意, `tag:div@text():text``tag:div@@text():text` 是有区别的,前者只在`div`的直接文本节点搜索,后者搜索`div`的整个内部。

View File

@ -151,8 +151,9 @@ print(page.timeouts)
## current_tab_index
此属性返回当前标签页的序号。
**注意:** 自动化过程中若手动点击标签页,会使被点击标签页的 handle 排到首位,从而导致排序与视觉效果不一致。
此属性返回当前标签页的序号。
!> **注意:** 自动化过程中若手动点击标签页,会使被点击标签页的 handle 排到首位,从而导致排序与视觉效果不一致。
## current_tab_handle

View File

@ -12,13 +12,12 @@
这些方法用于在页面中查找元素,详细用法见“[使用方法 -> 查找页面元素](查找页面元素)”章节。
## change_mode()
此方法用于转换`MixPage`对象的模式。
切换后默认在目标模式重新跳转到原模式所在 url。
**注意:** s 模式转 d 模式时,若浏览器当前网址域名和 s 模式不一样,必定会跳转。
切换后默认在目标模式重新跳转到原模式所在 url。
!> **注意:** s 模式转 d 模式时,若浏览器当前网址域名和 s 模式不一样,必定会跳转。
参数:
@ -279,7 +278,7 @@ page.to_frame(iframe)
返回None
**注意:** 自动化过程中若手动点击标签页,会使被点击标签页的 handle 排到首位,从而导致排序与视觉效果不一致。
!> **注意:** 自动化过程中若手动点击标签页,会使被点击标签页的 handle 排到首位,从而导致排序与视觉效果不一致。
```python
# 跳转到第一个标签页
@ -305,8 +304,9 @@ page.create_tab('http://www.baidu.com')
## close_tabs()
此方法用于关闭指定的标签页,标签页可以是序号或 handle 值,可关闭多个。默认关闭当前的。
**注意:** 当程序使用的是截关的浏览器,获取到的 handle 顺序和视觉效果不一致,不能按序号关闭。
此方法用于关闭指定的标签页,标签页可以是序号或 handle 值,可关闭多个。默认关闭当前的。
!> **注意:** 当程序使用的是截关的浏览器,获取到的 handle 顺序和视觉效果不一致,不能按序号关闭。
参数:
@ -324,8 +324,9 @@ page.close_tabs((0, 2))
## close_other_tabs()
此方法用于关闭指定标签页以外的标签页,标签页可以是序号或 handle 值,可保留多个。默认保留当前的。
**注意:** 当程序使用的是截关的浏览器,获取到的 handle 顺序和视觉效果不一致,不能按序号关闭。
此方法用于关闭指定标签页以外的标签页,标签页可以是序号或 handle 值,可保留多个。默认保留当前的。
!> **注意:** 当程序使用的是截关的浏览器,获取到的 handle 顺序和视觉效果不一致,不能按序号关闭。
参数:

View File

@ -33,7 +33,7 @@ page.get('https://www.baidu.com')
## 手动配置方式
**注意:** 这段代码只用于设置配置文件中的路径信息,**运行一次即可**,勿写到正式程序里 。
!> **注意:** 这段代码只用于设置配置文件中的路径信息,**运行一次即可**,勿写到正式程序里 。
有些版本的 Chrome 程序无法获取正确的 driver就须要手动配置路径。
新建一个**临时文件** ,修改并运行以下代码,可手动指定 Chrome 和 driver 路径,记录到配置文件,以后程序会自动读取其中的配置,无须再写。

View File

@ -19,7 +19,7 @@ page.get(url)
title = page('tag:h1').text
```
**Tips:** DrissionPage 自带默认 headers
?> **Tips:** DrissionPage 自带默认 headers
## 下载文件