Struct StaticElement 

pub struct StaticElement { /* private fields */ }

一个静态(离线解析)元素句柄。克隆代价低(共享同一份已解析文档)。

注意:内部持有 scraper 的解析树(基于 Rc 的 Tendril),故 StaticElement 不是 Send, 不能跨线程移动(不要在 tokio::spawn 的任务之间传递);在单个任务内顺序使用没有任何问题。 文档用 Rc(而非 Arc)共享:反正解析树不可跨线程,Rc 更轻量。

Implementations

impl StaticElement

pub fn parse(html: &str) -> Result<Self>

离线解析一段 HTML(文档或片段均可),返回其根元素。

pub fn tag(&self) -> Result<String>

标签名(小写)。

pub fn text(&self) -> Result<String>

元素可见文本(所有后代文本拼接,首尾去空白)。

pub fn attr(&self, name: &str) -> Result<Option<String>>

读取属性;不存在返回 None。

pub fn attrs(&self) -> Result<Vec<(String, String)>>

全部属性(名, 值)。

pub fn html(&self) -> Result<String>

该元素的 outer HTML。

pub fn inner_html(&self) -> Result<String>

该元素的 inner HTML。

pub fn ele(&self, selector: &str) -> Result<StaticElement>

在本元素子树内查找单个元素(DP 定位语法)。找不到 → Error::ElementNotFound。

pub fn eles(&self, selector: &str) -> Result<Vec<StaticElement>>

在本元素子树内查找全部匹配元素(DP 定位语法)。

pub fn table(&self) -> Result<Vec<Vec<String>>>

把 <table> 抽成二维表(行 × 单元格文本)。

本元素自身是 <table> 则直接用;否则取其内第一个 <table>。逐 <tr> 取其 <th>/<td> 文本 (首尾去空白)。空行(无单元格)跳过。表头行也在内(作为第 0 行);要按表头映射用 table_records。

pub fn table_records(&self) -> Result<Vec<HashMap<String, String>>>

把 <table> 抽成记录列表:用第一行作表头,其余每行映射为 表头→单元格 的 map。

列数多于表头时多出的列用 colN 兜底;表为空返回空 Vec。

Trait Implementations

impl Clone for StaticElement

fn clone(&self) -> StaticElement

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.