Struct Cell 

pub struct Cell { /* private fields */ }

A structure representing cell formatting for tables.

The Cell struct allows customization of table cells including height, alignment, font, and fill color.

Example

use plotlars::{Table, Cell, Plot, Text, Rgb};
use polars::prelude::*;

let dataset = df![
    "product" => &["Laptop", "Mouse", "Keyboard", "Monitor"],
    "price" => &[999.99, 29.99, 79.99, 299.99],
    "stock" => &[15, 250, 87, 42]
]
.unwrap();

let cell = Cell::new()
    .height(30.0)
    .align("left")
    .font("Arial")
    .fill(Rgb(240, 240, 240));

Table::builder()
    .data(&dataset)
    .columns(vec!["product", "price", "stock"])
    .cell(&cell)
    .plot_title(Text::from("Product Inventory"))
    .build()
    .plot();

Implementations

impl Cell

pub fn new() -> Self

Creates a new Cell instance with default values.

Examples found in repository

examples/table.rs (line 25)

fn main() {
    let dataset = df![
        "name" => &["Alice Johnson", "Bob Smith", "Charlie Davis", "Diana Martinez", "Eva Wilson"],
        "department" => &["Engineering", "Marketing", "Engineering", "Sales", "Marketing"],
        "salary" => &[95000, 78000, 102000, 85000, 82000],
        "years" => &[5, 3, 7, 4, 2]
    ]
    .unwrap();

    let header = Header::new()
        .values(vec![
            "Employee Name",
            "Department",
            "Annual Salary ($)",
            "Years of Service",
        ])
        .align("center")
        .font("Arial Bold")
        .fill(Rgb(70, 130, 180));

    let cell = Cell::new()
        .align("center")
        .height(25.0)
        .font("Arial")
        .fill(Rgb(240, 248, 255));

    Table::builder()
        .data(&dataset)
        .columns(vec!["name", "department", "salary", "years"])
        .header(&header)
        .cell(&cell)
        .plot_title(
            Text::from("Employee Data")
                .font("Arial")
                .size(20)
                .color(Rgb(25, 25, 112)),
        )
        .build()
        .plot();
}

pub fn height(self, height: f64) -> Self

Sets the height of the cells.

Argument

• height - A f64 value specifying the cell height.

Examples found in repository

examples/table.rs (line 27)

fn main() {
    let dataset = df![
        "name" => &["Alice Johnson", "Bob Smith", "Charlie Davis", "Diana Martinez", "Eva Wilson"],
        "department" => &["Engineering", "Marketing", "Engineering", "Sales", "Marketing"],
        "salary" => &[95000, 78000, 102000, 85000, 82000],
        "years" => &[5, 3, 7, 4, 2]
    ]
    .unwrap();

    let header = Header::new()
        .values(vec![
            "Employee Name",
            "Department",
            "Annual Salary ($)",
            "Years of Service",
        ])
        .align("center")
        .font("Arial Bold")
        .fill(Rgb(70, 130, 180));

    let cell = Cell::new()
        .align("center")
        .height(25.0)
        .font("Arial")
        .fill(Rgb(240, 248, 255));

    Table::builder()
        .data(&dataset)
        .columns(vec!["name", "department", "salary", "years"])
        .header(&header)
        .cell(&cell)
        .plot_title(
            Text::from("Employee Data")
                .font("Arial")
                .size(20)
                .color(Rgb(25, 25, 112)),
        )
        .build()
        .plot();
}

pub fn align(self, align: impl Into<String>) -> Self

Sets the alignment of the cell text.

Argument

• align - A string specifying the alignment (left, center, right).

Examples found in repository

examples/table.rs (line 26)

fn main() {
    let dataset = df![
        "name" => &["Alice Johnson", "Bob Smith", "Charlie Davis", "Diana Martinez", "Eva Wilson"],
        "department" => &["Engineering", "Marketing", "Engineering", "Sales", "Marketing"],
        "salary" => &[95000, 78000, 102000, 85000, 82000],
        "years" => &[5, 3, 7, 4, 2]
    ]
    .unwrap();

    let header = Header::new()
        .values(vec![
            "Employee Name",
            "Department",
            "Annual Salary ($)",
            "Years of Service",
        ])
        .align("center")
        .font("Arial Bold")
        .fill(Rgb(70, 130, 180));

    let cell = Cell::new()
        .align("center")
        .height(25.0)
        .font("Arial")
        .fill(Rgb(240, 248, 255));

    Table::builder()
        .data(&dataset)
        .columns(vec!["name", "department", "salary", "years"])
        .header(&header)
        .cell(&cell)
        .plot_title(
            Text::from("Employee Data")
                .font("Arial")
                .size(20)
                .color(Rgb(25, 25, 112)),
        )
        .build()
        .plot();
}

pub fn font(self, font: &str) -> Self

Sets the font family of the cell text.

Argument

• font - A string slice specifying the font family name.

Examples found in repository

examples/table.rs (line 28)

fn main() {
    let dataset = df![
        "name" => &["Alice Johnson", "Bob Smith", "Charlie Davis", "Diana Martinez", "Eva Wilson"],
        "department" => &["Engineering", "Marketing", "Engineering", "Sales", "Marketing"],
        "salary" => &[95000, 78000, 102000, 85000, 82000],
        "years" => &[5, 3, 7, 4, 2]
    ]
    .unwrap();

    let header = Header::new()
        .values(vec![
            "Employee Name",
            "Department",
            "Annual Salary ($)",
            "Years of Service",
        ])
        .align("center")
        .font("Arial Bold")
        .fill(Rgb(70, 130, 180));

    let cell = Cell::new()
        .align("center")
        .height(25.0)
        .font("Arial")
        .fill(Rgb(240, 248, 255));

    Table::builder()
        .data(&dataset)
        .columns(vec!["name", "department", "salary", "years"])
        .header(&header)
        .cell(&cell)
        .plot_title(
            Text::from("Employee Data")
                .font("Arial")
                .size(20)
                .color(Rgb(25, 25, 112)),
        )
        .build()
        .plot();
}

pub fn fill(self, fill: Rgb) -> Self

Sets the fill color of the cells.

Argument

• fill - An Rgb value specifying the background color.

Examples found in repository

examples/table.rs (line 29)

fn main() {
    let dataset = df![
        "name" => &["Alice Johnson", "Bob Smith", "Charlie Davis", "Diana Martinez", "Eva Wilson"],
        "department" => &["Engineering", "Marketing", "Engineering", "Sales", "Marketing"],
        "salary" => &[95000, 78000, 102000, 85000, 82000],
        "years" => &[5, 3, 7, 4, 2]
    ]
    .unwrap();

    let header = Header::new()
        .values(vec![
            "Employee Name",
            "Department",
            "Annual Salary ($)",
            "Years of Service",
        ])
        .align("center")
        .font("Arial Bold")
        .fill(Rgb(70, 130, 180));

    let cell = Cell::new()
        .align("center")
        .height(25.0)
        .font("Arial")
        .fill(Rgb(240, 248, 255));

    Table::builder()
        .data(&dataset)
        .columns(vec!["name", "department", "salary", "years"])
        .header(&header)
        .cell(&cell)
        .plot_title(
            Text::from("Employee Data")
                .font("Arial")
                .size(20)
                .color(Rgb(25, 25, 112)),
        )
        .build()
        .plot();
}

Trait Implementations

impl Clone for Cell

fn clone(&self) -> Cell

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Cell

fn default() -> Cell

Returns the “default value” for a type.