Struct Table 

pub struct Table { /* private fields */ }

A data table widget with column headers, row selection, and keyboard navigation.

Rows are provided as Vec<Vec<String>> — each inner Vec must match the number of columns. Use Table::columns and Table::rows for builder-style construction.

The table handles Up/Down keys internally for row selection. It is not focusable in the Tab chain — keyboard events reach it through a parent container’s forwarding.

Implementations

impl Table

pub fn new() -> Self

Creates an empty table.

pub fn columns(self, columns: Vec<TableColumn>) -> Self

Sets the column definitions.

pub fn rows(self, rows: Vec<Vec<String>>) -> Self

Sets the row data.

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

Sets the default cell style.

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

Sets the header row style.

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

Sets the selected row style.

pub fn selected(&self) -> Option<usize>

Returns the currently selected row index.

pub fn set_selected(&mut self, index: Option<usize>, cx: &mut EventCx<'_>)

Sets the selected row programmatically.

pub fn row_count(&self) -> usize

Returns the number of rows.

pub fn sort_by_column(&mut self, col: usize, cx: &mut EventCx<'_>)

Sorts rows by the given column index, in ascending order. Invalid column index is a no-op.

pub fn set_column_width(&mut self, col: usize, width: u16, cx: &mut EventCx<'_>)

Sets the width of a specific column. Minimum width is 3. Invalid column index is a no-op.

pub fn adjust_column_width( &mut self, col: usize, delta: i16, cx: &mut EventCx<'_>, )

Adjusts the width of a column by delta (positive = wider). Invalid column index is a no-op.

Trait Implementations

impl Component for Table

fn render(&self, cx: &mut RenderCx<'_>)

渲染组件内容

fn measure(&self, _constraint: Constraint, _cx: &mut MeasureCx) -> Size

测量组件在给定约束下的自适应尺寸

fn event(&mut self, event: &Event, cx: &mut EventCx<'_>)

处理事件（可选实现）

fn layout(&mut self, rect: Rect, _cx: &mut LayoutCx<'_>)

布局回调——组件在此计算子节点 rect 并调用 child.layout()

fn focusable(&self) -> bool

是否可聚焦（Tab 导航会跳过不可聚焦的组件）

fn style(&self) -> Style

返回组件样式（可选实现）

fn mount(&mut self, _cx: &mut EventCx<'_>)

首次挂载（初始化后调用）

fn unmount(&mut self, _cx: &mut EventCx<'_>)

从树卸载（退出前调用）

fn update(&mut self, _cx: &mut EventCx<'_>)

每次事件分发前调用

fn type_name(&self) -> &str

组件类型名（用于样式表类型选择器匹配）

fn id(&self) -> Option<&str>

组件 ID（用于样式表 #id 选择器匹配）

fn class(&self) -> Option<&str>

组件 class（用于样式表 .class 选择器匹配）

fn for_each_child(&self, _f: &mut dyn FnMut(&Node))

遍历子节点（为焦点系统等提供统一的树遍历接口）

fn for_each_child_mut(&mut self, _f: &mut dyn FnMut(&mut Node))

遍历子节点（可变版本）