DataCell

Examples

See these.

The data for a cell of a DataTable.

Inherits: Control

Properties

• content - The content of this cell.
• placeholder - Whether the content is actually a placeholder.
• show_edit_icon - Whether to show an edit icon at the end of this cell.

Events

• on_double_tap - Called when this cell is double tapped.
• on_long_press - Called if this cell is long-pressed.
• on_tap - Called if this cell is tapped.
• on_tap_cancel - Called if the user cancels a tap was started on cell.
• on_tap_down - Called if this cell is tapped down.

Properties

buildcontentinstance-attribute

content: Annotated[StrOrControl, V.str_or_visible_control()]

The content of this cell.

Typically a Text control or a Dropdown control.

If the cell has no data, then a Text control with placeholder text should be provided instead, and placeholder should be set to True.

Tip

To lay out multiple children, set the content to a container-like control such as Row, Column, or Stack, which have a controls property.

Raises:

• ValueError - If it is neither a string nor a visible Control.

buildplaceholderclass-attributeinstance-attribute

placeholder: bool = False

Whether the content is actually a placeholder.

If this is True, the default text style for the cell is changed to be appropriate for placeholder text.

buildshow_edit_iconclass-attributeinstance-attribute

show_edit_icon: bool = False

Whether to show an edit icon at the end of this cell.

This does not make the cell actually editable; the caller must implement editing behavior if desired (initiated from the on_tap callback).

Note

If this is set, on_tap should also be set, otherwise tapping the icon will have no effect.

Events

bolton_double_tapclass-attributeinstance-attribute

on_double_tap: Optional[ControlEventHandler[DataCell]] = None

Called when this cell is double tapped.

Note

If this is None (including on_tap, on_long_press, on_tap_cancel, on_tap_down), tapping this cell will attempt to select its row (if flet.DataRow.on_select_change is provided).

bolton_long_pressclass-attributeinstance-attribute

on_long_press: Optional[ControlEventHandler[DataCell]] = None

Called if this cell is long-pressed.

Note

If this is None (including on_tap, on_double_tap, on_tap_cancel, on_tap_down), tapping this cell will attempt to select its row (if flet.DataRow.on_select_change is provided).

bolton_tapclass-attributeinstance-attribute

on_tap: Optional[ControlEventHandler[DataCell]] = None

Called if this cell is tapped.

Note

If this is None (including on_double_tap, on_long_press, on_tap_cancel, on_tap_down), tapping this cell will attempt to select its row (if flet.DataRow.on_select_change is provided).

bolton_tap_cancelclass-attributeinstance-attribute

on_tap_cancel: Optional[ControlEventHandler[DataCell]] = None

Called if the user cancels a tap was started on cell.

Note

If this is None (including on_tap, on_double_tap, on_long_press, on_tap_down), tapping this cell will attempt to select its row (if flet.DataRow.on_select_change is provided).

bolton_tap_downclass-attributeinstance-attribute

on_tap_down: Optional[EventHandler[TapEvent[DataCell]]] = None

Called if this cell is tapped down.

Note

If this is None (including on_tap, on_double_tap, on_long_press, on_tap_cancel), tapping this cell will attempt to select its row (if flet.DataRow.on_select_change is provided).