Struct Table 

pub struct Table<'a> { /* private fields */ }

A widget to display data in a table.

Implementations

impl<'a> Table<'a>

pub fn new( rows: impl IntoIterator<Item = Row>, widths: impl IntoIterator<Item = Constraint>, ) -> Self

Create a new table with the given rows and column width constraints.

pub fn data_hash(self, hash: u64) -> Self

Set an explicit data hash to enable caching of filtered and sorted indices.

This is highly recommended for large tables. When provided, the table widget will cache the result of filtering and sorting in the TableState, skipping expensive O(N) re-evaluation on frames where the hash, filter, and sort parameters have not changed.

pub fn header(self, header: Row) -> Self

Set the header row.

pub fn block(self, block: Block<'a>) -> Self

Set the surrounding block.

pub fn style(self, style: Style) -> Self

Set the base table style.

pub fn highlight_style(self, style: Style) -> Self

Set the style for the selected row.

pub fn theme(self, theme: TableTheme) -> Self

Set the table theme (base/states/effects).

pub fn theme_phase(self, phase: f32) -> Self

Set the explicit animation phase for theme effects.

Phase is deterministic and should be supplied by the caller (e.g. from tick count).

pub fn column_spacing(self, spacing: u16) -> Self

Set the spacing between columns.

pub fn hit_id(self, id: HitId) -> Self

Set a hit ID for mouse interaction.

When set, each table row will register a hit region with the frame’s hit grid (if enabled). The hit data will be the row’s index, allowing click handlers to determine which row was clicked.

Trait Implementations

impl Accessible for Table<'_>

fn accessibility_nodes(&self, area: Rect) -> Vec<A11yNodeInfo>

Return accessibility node(s) for this widget at the given bounds.

impl<'a> Clone for Table<'a>

fn clone(&self) -> Table<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Table<'a>

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

Formats the value using the given formatter.

impl<'a> Default for Table<'a>

fn default() -> Table<'a>

Returns the “default value” for a type.

impl MeasurableWidget for Table<'_>

fn measure(&self, _available: Size) -> SizeConstraints

Measure the widget given available space.

fn has_intrinsic_size(&self) -> bool

Quick check: does this widget have content-dependent sizing?

impl<'a> StatefulWidget for Table<'a>

type State = TableState

The state type associated with this widget.

fn render(&self, area: Rect, frame: &mut Frame<'_>, state: &mut Self::State)

Render the widget into the frame, potentially modifying state.

impl<'a> Widget for Table<'a>

fn render(&self, area: Rect, frame: &mut Frame<'_>)

Render the widget into the frame at the given area.

fn is_essential(&self) -> bool

Whether this widget is essential and should always render.