🚤 获取元素信息
浏览器元素对应的对象是ChromiumElement
和ShadowRoot
,本节介绍获取到元素对象后,如何获取其信息。
ChromiumElement
拥有SessionElement
所有属性,并有更多浏览器专属的信息。本节重点介绍如何获取浏览器专有的元素信息。
✅️️ 与SessionElement
共有信息
此处仅列出列表,具体用法请查看收发数据包部分的“获取元素信息”。
属性或方法 | 说明 |
---|---|
html | 此属性返回元素的 outerHTML 文本(不包括<iframe> 内容) |
inner_html | 此属性返回元素的 innerHTML 文本 |
tag | 此属性返回元素的标签名 |
text | 此属性返回元素内所有文本组合成的字符串 |
raw_text | 此属性返回元素内原始文本 |
texts() | 此方法返回元素内所有直接子节点的文本,包括元素和文本节点 |
comments | 此属性以列表形式返回元素内的注释 |
attrs | 此属性以字典形式返回元素所有属性及值 |
attr() | 此方法返回元素某个 attribute 属性值 |
link | 此方法返回元素的 href 属性或 src 属性 |
page | 此属性返回元素所在的总控页面对象 |
xpath | 此属性返回当前元素在页面中 xpath 的绝对路径 |
css_path | 此属性返回当前元素在页面中 css selector 的绝对路径 |
✅️️ 大小和位置
📌 rect.size
此属性以元组形式返回元素的大小。
类型:Tuple[float, float]
size = ele.rect.size
# 返回:(50, 50)
📌 rect.location
此属性以元组形式返回元素左上角在整个页面中的坐标。
类型:Tuple[float, float]
loc = ele.rect.location
# 返回:(50, 50)
📌 rect.midpoint
此属性以元组形式返回元素中点在整个页面中的坐标。
类型:Tuple[float, float]
loc = ele.rect.midpoint
# 返回:(55, 55)
📌 rect.click_point
此属性以元组形式返回元素点击点在整个页面中的坐标。
点击点是指click()
方法点击时的位置,位于元素中上部。
类型:Tuple[float, float]
📌 rect.viewport_location
此属性以元组形式返回元素左上角在当前视口中的坐标。
类型:Tuple[float, float]
📌 rect.viewport_midpoint
此属性以元组形式返回元素中点在当前视口中的坐标。
类型:Tuple[floatt, float]
📌 rect.viewport_click_point
此属性以元组形式返回元素点击点在当前视口中的坐标。
类型:Tuple[float, float]
📌 rect.screen_location
此属性以元组形式返回元素左上角在屏幕中的坐标。
类型:Tuple[float, float]
📌 rect.screen_midpoint
此属性以元组形式返回元素中点在屏幕中的坐标。
类型:Tuple[float, float]
📌 rect.screen_click_point
此属性以元组形式返回元素点击点在屏幕中的坐标。
类型:Tuple[float, float]
📌 rect.corners
此属性以列表形式返回元素四个角在页面中的坐标,顺序:左上、右上、右下、左下。
类型:((float, float), (float, float), (float, float), (float, float),)
📌 rect.viewport_corners
此属性以列表形式返回元素四个角在视口中的坐标,顺序:左上、右上、右下、左下。
类型:list[(float, float), (float, float), (float, float), (float, float)]
📌 rect.viewport_rect
此属性以列表形式返回元素四个角在视口中的坐标,顺序:左上、右上、右下、左下。
类型:List[(float, float), (float, float), (float, float), (float, float)]
✅️️ 属性和内容
📌 pseudo.before
此属性以文本形式返回当前元素的::before
伪元素内容。
类型:str
before_txt = ele.pseudo.before
📌 pseudo.after
此属性以文本形式返回当前元素的::after
伪元素内容。
类型:str
after_txt = ele.pseudo.after
📌 style()
该方法返回元素 css 样式属性值,可获取伪元素的属性。它有两个参数,style
参数输入样式属性名称,pseudo_ele
参数输入伪元素名称,省略则获取普通元素的 css 样式属性。
参数名称 | 类型 | 默认值 | 说明 |
---|---|---|---|
style | str | 必填 | 样式名称 |
pseudo_ele | str | '' | 伪元素名称(如有) |
返回类型 | 说明 |
---|---|
str | 样式属性值 |
示例:
# 获取 css 属性的 color 值
prop = ele.style('color')
# 获取 after 伪元素的内容
prop = ele.style('content', 'after')
📌 property()
此方法返回property
属性值。它接收一个字符串参数,返回该参数的属性值。
参数名称 | 类型 | 默认值 | 说明 |
---|---|---|---|
name | str | 必填 | 属性名称 |
返回 类型 | 说明 |
---|---|
str | 属性值 |
📌 shadow_root
此属性返回元素内的 shadow-root 对象,没有的返回None
。
类型:ShadowRoot
✅️️ 元素列表中批量获取信息
eles()
等返回的元素列表,自带get
属性,可用于获取指定信息。
📌 示例
from DrissionPage import SessionPage
page = SessionPage()
page.get('https://www.baidu.com')
eles = page('#s-top-left').eles('t:a')
print(eles.get.texts()) # 获取所有元素的文本
输出:
['新闻', 'hao123', '地图', '贴吧', '视频', '图片', '网盘', '文库', '更多', '翻译', '学术', '百科', '知道', '健康', '营销推广', '直播', '音乐', '橙篇', '查看全部百度产品 >']
📌 get.attrs()
此方法用于返回所有元素指定的 attribute 属性组成的列表。
参数名称 | 类型 | 默认值 | 说明 |
---|---|---|---|
name | str | 必填 | 属性名称 |
返回类型 | 说明 |
---|---|
List[str] | 属性文本组成的列表 |
📌 get.links()
此方法用于返回所有元素的link
属性组成的列表。
参数: 无
返回类型 | 说明 |
---|---|
List[str] | 链接文本组成的列表 |