Struct build_html::Table

pub struct Table { /* fields omitted */ }

Represents an HTML <table> element with all its children.

The easiest way to make a table is by simply passing in a 2D Array or Vec. Using this method, the entire contents will be placed in <td> elements within the <tbody>. If a header row is desired, one can be added manually.

Example

let source_table = [
    [1, 2, 3],
    [4, 5, 6],
    [7, 8, 9]
];
let html_table = Table::from(source_table)
    .add_header_row(['A', 'B', 'C'])
    .to_html_string();

assert_eq!(
    html_table,
    concat!(
        "<table><thead>",
        "<tr><th>A</th><th>B</th><th>C</th></tr>",
        "</thead><tbody>",
        "<tr><td>1</td><td>2</td><td>3</td></tr>",
        "<tr><td>4</td><td>5</td><td>6</td></tr>",
        "<tr><td>7</td><td>8</td><td>9</td></tr>",
        "</tbody></table>"
    )
);

Implementations

impl Table

pub fn new() -> Self

Creates a new table with an empty header and body

pub fn with_attributes<A, S>(self, attributes: A) -> Self where
    A: IntoIterator<Item = (S, S)>,
    S: ToString, 

Associates the specified map of attributes with this Table.

Note that this operation overrides all previous with_attribute calls on this Table

Example

let table = Table::new()
    .with_attributes([("id", "my-table")])
    .to_html_string();

assert_eq!(
    table,
    r#"<table id="my-table"><thead></thead><tbody></tbody></table>"#
);

pub fn add_header_row<T>(self, row: T) -> Self where
    T: IntoIterator,
    T::Item: Display, 

Adds the specified row to the table header

Note that no checking is done to ensure that the row is of the proper length

Example

let table = Table::new()
    .add_header_row(vec!["Mon", "Tues", "Wed", "Thurs", "Fri"])
    .to_html_string();

assert_eq!(
    table,
    concat!(
        "<table><thead>",
        "<tr><th>Mon</th><th>Tues</th><th>Wed</th><th>Thurs</th><th>Fri</th></tr>",
        "</thead><tbody></tbody></table>"
    )
)

pub fn add_body_row<T>(self, row: T) -> Self where
    T: IntoIterator,
    T::Item: Display, 

Adds the specified row to the table body

Note that no checking is done to ensure that the row is of the proper length

Example

let table = Table::new()
    .add_body_row(vec![1, 2, 3, 4, 5])
    .to_html_string();

assert_eq!(
    table,
    concat!(
        "<table><thead></thead><tbody>",
        "<tr><td>1</td><td>2</td><td>3</td><td>4</td><td>5</td></tr>",
        "</tbody></table>"
    )
)

Trait Implementations

impl Debug for Table

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

Formats the value using the given formatter.

impl Default for Table

fn default() -> Self

Returns the “default value” for a type.

impl<T> From<T> for Table where
    T: IntoIterator,
    T::Item: IntoIterator,
    <<T as IntoIterator>::Item as IntoIterator>::Item: Display, 

fn from(source: T) -> Self

Performs the conversion.

impl Html for Table

fn to_html_string(&self) -> String

Convert this element into an HTML string