Enum PdfBlock 

#[non_exhaustive]
pub enum PdfBlock {
    Heading {
        level: u8,
        text: String,
        source: SourceLocation,
    },
    Paragraph {
        text: String,
        source: SourceLocation,
    },
    List {
        ordered: bool,
        items: Vec<ListItem>,
        source: SourceLocation,
    },
    Table {
        headers: Vec<String>,
        rows: Vec<Vec<String>>,
        source: SourceLocation,
    },
    Image {
        data: ImageData,
        source: SourceLocation,
    },
    Code {
        language: Option<String>,
        text: String,
        source: SourceLocation,
    },
    Formula {
        latex: String,
        source: SourceLocation,
    },
    PageBreak {
        source: SourceLocation,
    },
    Footnote {
        reference_id: String,
        text: String,
        source: SourceLocation,
    },
    TableCell {
        row_span: u32,
        col_span: u32,
        text: String,
        source: SourceLocation,
    },
    BlockQuote {
        text: String,
        source: SourceLocation,
    },
    HorizontalRule {
        source: SourceLocation,
    },
    Link {
        url: String,
        text: String,
        source: SourceLocation,
    },
    Unknown {
        raw: String,
        source: SourceLocation,
    },
}

从 PDF 页面识别出的语义内容块。

#[non_exhaustive] 保证未来新增变体不会破坏下游代码。 消费方应始终包含通配分支（_ => ...）或使用 block_type 进行分发。

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Heading

分级标题。

Fields

level: u8

标题级别，范围为 1 到 6。

text: String

标题文本。

source: SourceLocation

源位置。

Paragraph

普通段落。

Fields

text: String

段落文本。

source: SourceLocation

源位置。

List

有序或无序列表。

Fields

ordered: bool

是否为有序列表。

items: Vec<ListItem>

列表项（支持嵌套）。

source: SourceLocation

源位置。

Table

表格数据。

Fields

headers: Vec<String>

表头。

rows: Vec<Vec<String>>

表格行。

source: SourceLocation

源位置。

Image

图片引用。

Fields

data: ImageData

图片元数据。

source: SourceLocation

源位置。

Code

代码块。

Fields

language: Option<String>

代码语言标识（如 "rust"、"python"）。

text: String

代码文本。

source: SourceLocation

源位置。

Formula

数学公式（LaTeX 语法）。

Fields

latex: String

LaTeX 源码。

source: SourceLocation

源位置。

PageBreak

分页符。

Fields

source: SourceLocation

源位置。

Footnote

脚注。

Fields

reference_id: String

脚注引用标识。

text: String

脚注正文。

source: SourceLocation

源位置。

TableCell

表格单元格（细粒度识别）。

Fields

row_span: u32

行跨度。

col_span: u32

列跨度。

text: String

单元格文本。

source: SourceLocation

源位置。

BlockQuote

引用块。

Fields

text: String

引用文本。

source: SourceLocation

源位置。

HorizontalRule

水平分隔线。

Fields

source: SourceLocation

源位置。

Link

超链接。

Fields

url: String

链接地址。

text: String

链接显示文本。

source: SourceLocation

源位置。

Unknown

无法识别的内容。

Fields

raw: String

原始文本。

source: SourceLocation

源位置。

Implementations

impl PdfBlock

pub fn heading( level: u8, text: impl Into<String>, source: SourceLocation, ) -> Self

创建分级标题。

pub fn paragraph(text: impl Into<String>, source: SourceLocation) -> Self

创建普通段落。

pub fn list(ordered: bool, items: Vec<ListItem>, source: SourceLocation) -> Self

创建有序或无序列表。

pub fn table( headers: Vec<String>, rows: Vec<Vec<String>>, source: SourceLocation, ) -> Self

创建表格。

pub fn image(data: ImageData, source: SourceLocation) -> Self

创建图片引用。

pub fn code(text: impl Into<String>, source: SourceLocation) -> Self

创建代码块。

pub fn code_with_language( language: impl Into<String>, text: impl Into<String>, source: SourceLocation, ) -> Self

创建带语言标识的代码块。

pub fn formula(latex: impl Into<String>, source: SourceLocation) -> Self

创建数学公式。

pub const fn page_break(source: SourceLocation) -> Self

创建分页符。

pub fn footnote( ref_id: impl Into<String>, text: impl Into<String>, source: SourceLocation, ) -> Self

创建脚注。

pub fn table_cell( row_span: u32, col_span: u32, text: impl Into<String>, source: SourceLocation, ) -> Self

创建表格单元格。

pub fn block_quote(text: impl Into<String>, source: SourceLocation) -> Self

创建引用块。

pub const fn horizontal_rule(source: SourceLocation) -> Self

创建水平分隔线。

pub fn link( url: impl Into<String>, text: impl Into<String>, source: SourceLocation, ) -> Self

创建超链接。

pub fn unknown(raw: impl Into<String>, source: SourceLocation) -> Self

创建无法识别的内容。

pub const fn source(&self) -> &SourceLocation

返回内容块的源位置。

pub const fn block_type(&self) -> PdfBlockType

返回内容块的语义分类。

Examples

use easypdf_core::{PdfBlock, PdfBlockType, SourceLocation};
use easypdf_core::PageIndex;

let loc = SourceLocation::new(PageIndex::new(0), 1.0);
let block = PdfBlock::heading(1, "Title", loc);
assert_eq!(block.block_type(), PdfBlockType::Heading);

Trait Implementations

impl Clone for PdfBlock

fn clone(&self) -> PdfBlock

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PdfBlock

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for PdfBlock

fn eq(&self, other: &PdfBlock) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for PdfBlock