Struct DataTable 

pub struct DataTable<D: TableDelegate> { /* private fields */ }

A table element with support for row, column, and cell selection.

Features

• Multiple Selection Modes: Support for row, column, and cell selection
• Cell Selection: Click to select individual cells, with keyboard navigation
• Virtual Scrolling: Efficient rendering of large datasets
• Resizable Columns: Drag column borders to resize
• Movable Columns: Drag column headers to reorder
• Fixed Columns: Pin columns to the left side
• Sortable Columns: Click column headers to sort
• Context Menus: Right-click support for rows and cells

Cell Selection Mode

When cell selection is enabled via TableState::cell_selectable():

• Click on cells to select them
• A row header column appears on the left for selecting entire rows (use TableState::row_header() to hide it)
• Keyboard navigation (arrow keys, Tab, Home, End, PageUp, PageDown) works at cell level
• Right-click and double-click events are supported

See TableState for more details on cell selection.

Example

let table_state = cx.new(|cx| {
    TableState::new(delegate, cx)
        .cell_selectable(true)
        .row_selectable(true)
});

DataTable::new(&table_state)
    .stripe(true)
    .bordered(true)

Implementations

impl<D> DataTable<D>

where D: TableDelegate,

pub fn new(state: &Entity<TableState<D>>) -> Self

Create a new DataTable element with the given TableState.

pub fn stripe(self, stripe: bool) -> Self

Set to use stripe style of the table, default to false.

pub fn scroll_bounce(self, enabled: bool) -> Self

Bounce the rows at the vertical boundaries, keeping headers and scrollbars fixed. On by default on iOS, Android and macOS, off elsewhere.

pub fn bordered(self, bordered: bool) -> Self

Set to use border style of the table, default to true.

pub fn header_row_height(self, height: impl Into<Pixels>) -> Self

Set the height of each header row.

Column-group rows use the same height, so the whole header is this height times the number of header rows. Body rows keep the height from Size::table_row_height. When this is unset, header rows use that same height.

pub fn fixed_cols_border(self, fixed_cols_border: bool) -> Self

Set whether to draw the border on the right edge of the fixed columns, default to true.

Turn it off when the fixed cells draw that edge themselves, so the boundary is not drawn twice.

pub fn scrollbar_visible(self, vertical: bool, horizontal: bool) -> Self

Set scrollbar visibility.

Trait Implementations

impl<D> FocusableExt for DataTable<D>

where D: TableDelegate,

fn focus_ring(self, enabled: bool) -> Self

fn is_focus_ring_enabled(&self) -> bool

impl<D: TableDelegate> IntoElement for DataTable<D>

type Element = ViewElement<DataTable<D>>

The specific type of element into which the implementing type is converted. Useful for converting other types into elements automatically, like Strings

fn into_element(self) -> Self::Element

Convert self into a type that implements Element.

fn into_any_element(self) -> AnyElement

Convert self into a dynamically-typed AnyElement.

impl<D> RenderOnce for DataTable<D>

where D: TableDelegate,

fn render(self, window: &mut Window, cx: &mut App) -> impl IntoElement

Render this component into an element tree. Note that this method takes ownership of self, as compared to Render::render() method which takes a mutable reference.

impl<D> Sizable for DataTable<D>

where D: TableDelegate,

fn with_size(self, size: impl Into<Size>) -> Self

Set the ui::Size of this element.

fn xsmall(self) -> Self

Set to Size::XSmall

fn small(self) -> Self

Set to Size::Small

fn large(self) -> Self

Set to Size::Large