Table class

A widget that uses the table layout algorithm for its children.

This sample shows a Table with borders, multiple types of column widths and different vertical cell alignments.

To create a local project with this code sample, run:
flutter create --sample=widgets.Table.1 mysample

If you only have one row, the Row widget is more appropriate. If you only have one column, the SliverList or Column widgets will be more appropriate.

Rows size vertically based on their contents. To control the individual column widths, use the columnWidths property to specify a TableColumnWidth for each column. If columnWidths is null, or there is a null entry for a given column in columnWidths, the table uses the defaultColumnWidth instead.

By default, defaultColumnWidth is a FlexColumnWidth. This TableColumnWidth divides up the remaining space in the horizontal axis to determine the column width. If wrapping a Table in a horizontal ScrollView, choose a different TableColumnWidth, such as FixedColumnWidth.

For more details about the table layout algorithm, see RenderTable. To control the alignment of children, see TableCell.

See also:



Table({Key? key, List<TableRow> children = const <TableRow>[], Map<int, TableColumnWidth>? columnWidths, TableColumnWidth defaultColumnWidth = const FlexColumnWidth(), TextDirection? textDirection, TableBorder? border, TableCellVerticalAlignment defaultVerticalAlignment =, TextBaseline? textBaseline})
Creates a table.


border TableBorder?
The style to use when painting the boundary and interior divisions of the table.
children List<TableRow>
The rows of the table.
columnWidths Map<int, TableColumnWidth>?
How the horizontal extents of the columns of this table should be determined.
defaultColumnWidth TableColumnWidth
How to determine with widths of columns that don't have an explicit sizing algorithm.
defaultVerticalAlignment TableCellVerticalAlignment
How cells that do not explicitly specify a vertical alignment are aligned vertically.
hashCode int
The hash code for this object.
no setterinherited
key Key?
Controls how one widget replaces another widget in the tree.
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
textBaseline TextBaseline?
The text baseline to use when aligning rows using TableCellVerticalAlignment.baseline.
textDirection TextDirection?
The direction in which the columns are ordered.


createElement() RenderObjectElement
RenderObjectWidgets always inflate to a RenderObjectElement subclass.
createRenderObject(BuildContext context) RenderTable
Creates an instance of the RenderObject class that this RenderObjectWidget represents, using the configuration described by this RenderObjectWidget.
debugDescribeChildren() List<DiagnosticsNode>
Returns a list of DiagnosticsNode objects describing this node's children.
debugFillProperties(DiagnosticPropertiesBuilder properties) → void
Add additional properties associated with the node.
didUnmountRenderObject(covariant RenderObject renderObject) → void
A render object previously associated with this widget has been removed from the tree. The given RenderObject will be of the same type as returned by this object's createRenderObject.
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
toDiagnosticsNode({String? name, DiagnosticsTreeStyle? style}) DiagnosticsNode
Returns a debug representation of the object that is used by debugging tools and by DiagnosticsNode.toStringDeep.
toString({DiagnosticLevel minLevel =}) String
A string representation of this object.
toStringDeep({String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug}) String
Returns a string representation of this node and its descendants.
toStringShallow({String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) String
Returns a one-line detailed description of the object.
toStringShort() String
A short, textual description of this widget.
updateRenderObject(BuildContext context, covariant RenderTable renderObject) → void
Copies the configuration described by this RenderObjectWidget to the given RenderObject, which will be of the same type as returned by this object's createRenderObject.


operator ==(Object other) bool
The equality operator.