The TableView2 is an advanced JavaFX TableView control, that can be used as drop-in replacement control for the existing TableView, and provides different functionalities and use cases.

Features

Rows can be fixed to the top of the TableView2 so that they are always visible on screen.
Columns can be fixed to the left of the TableView2 so that they are always visible on screen.
A row header can be switched on in order to display any custom content.
The column header can be extended to provide custom content.
FilteredTableView is a subclass of TableView2 with extended filtering options

Fixing Rows and Columns

Rows and columns can be fixed using dedicated actions like ColumnFixAction and RowFixAction. When fixed, the header's background will show a darker color. For instance, these actions can be attached to a ContextMenu that can be installed to the row header cells with rowHeaderContextMenuFactory.
You have also the possibility to fix them manually by adding and removing items from getFixedRows() and getFixedColumns(). But you are strongly advised to check if it's possible to do so with isColumnFixable(int) for the fixed columns and with isRowFixable(int) for the fixed rows.

If you want to fix several rows or columns together, you can call areRowsFixable(List) or areTableViewColumnsFixable(List) to verify if you can fix them. Calling those methods prior every move will ensure that no exception will be thrown.
You have also the possibility to deactivate these features.

Row Headers

You can also access and toggle row header's visibility by using the method provided setRowHeaderVisible(boolean). By default the row header will show the row index, but you can set the content with setRowHeader(TableColumn).

Cell editing

Two specialized cell factories are available TextField2TableCell and ComboBox2TableCell, providing support for commit on focus lost.

Filtering options

While filtering can be implemented as in a regular JavaFX TableView control, see FilteredTableView for extended filtering options.

Features not supported

Cell spanning is not supported yet.

Sample

Let's provide the underlying data model, based on a Person class.

public class Person {
    private StringProperty firstName;
    public void setFirstName(String value) { firstNameProperty().set(value); }
    public String getFirstName() { return firstNameProperty().get(); }
    public StringProperty firstNameProperty() {
        if (firstName == null) firstName = new SimpleStringProperty(this, "firstName");
        return firstName;
    }

    private StringProperty lastName;
    public void setLastName(String value) { lastNameProperty().set(value); }
    public String getLastName() { return lastNameProperty().get(); }
    public StringProperty lastNameProperty() {
        if (lastName == null) lastName = new SimpleStringProperty(this, "lastName");
        return lastName;
    }
}

A TableView2 can be created, and filled with an observable list of people:

TableView2<Person> table = new TableView2<Person>();
ObservableList<Person> people = getPeople();
table.setItems(people);

Now we add two columns to the table:

TableColumn2<Person,String> firstNameCol = new TableColumn2<>("First Name");
firstNameCol.setCellValueFactory(p -> p.getValue().firstNameProperty());
TableColumn2<Person,String> lastNameCol = new TableColumn2<>("Last Name");
lastNameCol.setCellValueFactory(p -> p.getValue().lastNameProperty());

table.getColumns().setAll(firstNameCol, lastNameCol);

A cell factory that allows commit on focus lost can be set:

firstName.setCellFactory(TextField2TableCell.forTableColumn());

We can fix some row and columns, and also show the row header:

table.getFixedColumns().setAll(firstNameColumn);
table.getFixedRows().setAll(0, 1, 2);

table.setRowHeaderVisible(true);

Nested and Inner Type Summary

Modifier and Type	Class and Description
public static enum	TableView2.SpanType The SpanType describes in which state each cell can be.</center>

Field Summary

Modifier and Type	Field and Description
private final BooleanProperty	columnFixingEnabled
private static final double	DEFAULT_ROW_HEADER_WIDTH Default width of the VerticalHeader.
private final ObservableList<TableColumn<S, T>>	fixedColumns
private final ListChangeListener<TableColumn<S, T>>	fixedColumnsListener
private final ObservableList<Integer>	fixedRows Private Fields * *
private final ListChangeListener<Integer>	fixedRowsListener ********************************************************************* * private listeners ********************************************************************
private BitSet	rowFix
private final BooleanProperty	rowFixingEnabled
private final ObjectProperty<TableColumn<S, ?>>	rowHeader The row header property wraps a `TableColumn` that can be used to render the row header.
private ObjectProperty<BiFunction<Integer, S, ContextMenu>>	rowHeaderContextMenuFactory An object property of a `BiFunction` that can be used to define the context menu of each row of the row header.
private final BooleanProperty	rowHeaderVisible
private final DoubleProperty	rowHeaderWidth The vertical header width, just for the Label.
private final BooleanProperty	southHeaderBlended This property allows the developer to blend the south table header row with the regular table header row, so for each column, the regular header and the south table column header look like a single one.
private String	stylesheet

Inherited from javafx.scene.control.TableView:: CONSTRAINED_RESIZE_POLICY CONSTRAINED_RESIZE_POLICY_ALL_COLUMNS CONSTRAINED_RESIZE_POLICY_FLEX_LAST_COLUMN CONSTRAINED_RESIZE_POLICY_FLEX_NEXT_COLUMN CONSTRAINED_RESIZE_POLICY_LAST_COLUMN CONSTRAINED_RESIZE_POLICY_NEXT_COLUMN CONSTRAINED_RESIZE_POLICY_SUBSEQUENT_COLUMNS DEFAULT_SORT_POLICY UNCONSTRAINED_RESIZE_POLICY

Constructor Summary

Access	Constructor and Description
public	TableView2() Creates a TableView2 control with no content.
public	TableView2(ObservableList<S> The items to insert into the TableView2, and the list to watch for changes (to automatically show in the TableView2). items) Creates a TableView2 with the content provided in the items ObservableList.

Method Summary

Modifier and Type	Method and Description
private boolean	Returns: true if the List of columns can be fixed together. areColumnsFixable(List<? extends Integer> list of column indices list) This method is the same as `areTableViewColumnsFixable(List)` but is using a List of `TableColumn` indices.
public final boolean	Returns: true if the List of row can be fixed together. areRowsFixable(List<? extends Integer> List of rows indices list) Indicates whether a List of rows can be fixed or not.
private boolean	Returns: true if the List of columns can be fixed together. areTableViewColumnsFixable(List<? extends TableColumn<S, T>> list of `TableColumn` list) Indicates whether a List of `TableColumn` can be fixed or not.
public final ReadOnlyBooleanProperty	Returns: the Boolean property associated with the allowance of fixing or unfixing some columns. columnFixingEnabledProperty() Return the Boolean property associated with the allowance of fixing or unfixing some columns.
private String	computeReason(List<? extends Integer> list)
protected Skin<?>	createDefaultSkin() Overrides javafx.scene.control.TableView.createDefaultSkin. Create a new instance of the default skin for this control.
public int	Returns: the current column span of a Cell. getColumnSpan(TablePosition<?, ?> The `TablePosition` pos) Return the current column span.
public final ObservableList<TableColumn<S, T>>	Returns: an ObservableList of the fixed columns. getFixedColumns() You can fix or unfix a column by modifying this list.
public final ObservableList<Integer>	Returns: an ObservableList of integer representing the fixedRows. getFixedRows() You can fix or unfix a row by modifying this list.
public final TableColumn<S, ?>	getRowHeader()
public final BiFunction<Integer, S, ContextMenu>	getRowHeaderContextMenuFactory()
public final double	getRowHeaderWidth() Returns: the current width of the row header.
public int	Returns: the current row span for the given cell. getRowSpan(TablePosition<?, ?> the `TablePosition` pos, int the index index) Return the current row span at the given position in the Table.
public TableView2.SpanType	Returns: The `SpanType` of a cell getSpanType(final int the number of row rowIndex, final int the number of column modelColumn) Return the `SpanType` of a cell.
public String	getUserAgentStylesheet() Overrides javafx.scene.layout.Region.getUserAgentStylesheet. An implementation may specify its own user-agent styles for this Region, and its children, by overriding this method.
private void	initRowFix() Private/Protected Implementation * *
public final boolean	Returns: true if the column if fixable isColumnFixable(int the number of column columnIndex) Indicate whether this column can be fixed or not.
public final boolean	Returns: whether changes to Fixed columns are enabled. isColumnFixingEnabled() Return whether changes to Fixed columns are enabled.
public final boolean	Returns: true if the row can be fixed. isRowFixable(int the number of row row) Indicate whether a row can be fixed or not.
public final boolean	Returns: whether changes to Fixed rows are enabled. isRowFixingEnabled() Return whether changes to Fixed rows are enabled.
public final boolean	Returns: a boolean telling if the row header is being shown isRowHeaderVisible() Return if the row header is showing.
public final boolean	isSouthHeaderBlended()
public final ReadOnlyBooleanProperty	Returns: the Boolean property associated with the allowance of fixing or unfixing some rows. rowFixingEnabledProperty() Return the Boolean property associated with the allowance of fixing or unfixing some rows.
public final ObjectProperty<BiFunction<Integer, S, ContextMenu>>	rowHeaderContextMenuFactoryProperty()
public final ObjectProperty<TableColumn<S, ?>>	rowHeaderProperty()
public final BooleanProperty	Returns: the BooleanProperty associated with the row header. rowHeaderVisibleProperty() BooleanProperty associated with the row Header.
public final DoubleProperty	Returns: A DoubleProperty. rowHeaderWidthProperty() This DoubleProperty represents the with of the rowHeader.
public final void	setColumnFixingEnabled(boolean If set to true, user will be allowed to fix and unfix the columns b) If set to true, user will be allowed to fix and unfix the columns.
public final void	setRowFixingEnabled(boolean If set to true, user will be allowed to fix and unfix the rows b) If set to true, user will be allowed to fix and unfix the rows.
public final void	setRowHeader(TableColumn<S, ?> value)
public final void	setRowHeaderContextMenuFactory(BiFunction<Integer, S, ContextMenu> value)
public final void	setRowHeaderVisible(final boolean boolean to show or hide the header b) Activate and deactivate the row header.
public final void	setRowHeaderWidth(double the new width value) Specify a new width for the row header.
public final void	setSouthHeaderBlended(boolean value)
public void	sort() Overrides javafx.scene.control.TableView.sort. Overrides `TableView#sort()` in order to fire custom sort events when sorting starts and finishes.
public final BooleanProperty	southHeaderBlendedProperty()

Inherited from javafx.scene.control.TableView:: columnResizePolicyProperty comparatorProperty edit editableProperty editingCellProperty fixedCellSizeProperty focusModelProperty getClassCssMetaData getColumnResizePolicy getColumns getComparator getControlCssMetaData getEditingCell getFixedCellSize getFocusModel getItems getOnScrollTo getOnScrollToColumn getOnSort getPlaceholder getRowFactory getSelectionModel getSortOrder getSortPolicy getVisibleLeafColumn getVisibleLeafColumns getVisibleLeafIndex isEditable isTableMenuButtonVisible itemsProperty onScrollToColumnProperty onScrollToProperty onSortProperty placeholderProperty queryAccessibleAttribute refresh resizeColumn rowFactoryProperty scrollTo scrollTo scrollToColumn scrollToColumnIndex selectionModelProperty setColumnResizePolicy setEditable setFixedCellSize setFocusModel setItems setOnScrollTo setOnScrollToColumn setOnSort setPlaceholder setRowFactory setSelectionModel setSortPolicy setTableMenuButtonVisible sortPolicyProperty tableMenuButtonVisibleProperty

Field Detail

columnFixingEnabled	back to summary
private final BooleanProperty columnFixingEnabled

DEFAULT_ROW_HEADER_WIDTH	back to summary
private static final double DEFAULT_ROW_HEADER_WIDTH Default width of the VerticalHeader.

fixedColumns	back to summary
private final ObservableList<TableColumn<S, T>> fixedColumns

fixedColumnsListener	back to summary
private final ListChangeListener<TableColumn<S, T>> fixedColumnsListener

fixedRows	back to summary
private final ObservableList<Integer> fixedRows Private Fields * *

fixedRowsListener	back to summary
private final ListChangeListener<Integer> fixedRowsListener ********************************************************************* * private listeners ********************************************************************

rowFix	back to summary
private BitSet rowFix

rowFixingEnabled	back to summary
private final BooleanProperty rowFixingEnabled

rowHeader	back to summary
private final ObjectProperty<TableColumn<S, ?>> rowHeader The row header property wraps a `TableColumn` that can be used to render the row header. By default, if this property is not set, a TableColumn will be used to render the number of row, starting from 1.

rowHeaderContextMenuFactory	back to summary
private ObjectProperty<BiFunction<Integer, S, ContextMenu>> rowHeaderContextMenuFactory An object property of a `BiFunction` that can be used to define the context menu of each row of the row header. See `RowFixAction`.

rowHeaderVisible	back to summary
private final BooleanProperty rowHeaderVisible

rowHeaderWidth	back to summary
private final DoubleProperty rowHeaderWidth The vertical header width, just for the Label.

southHeaderBlended	back to summary
private final BooleanProperty southHeaderBlended This property allows the developer to blend the south table header row with the regular table header row, so for each column, the regular header and the south table column header look like a single one.

stylesheet	back to summary
private String stylesheet

Constructor Detail

TableView2	back to summary
public TableView2() Creates a TableView2 control with no content.

TableView2	back to summary
public TableView2(ObservableList<S> items) Creates a TableView2 with the content provided in the items ObservableList. Parameters items:ObservableList<S> The items to insert into the TableView2, and the list to watch for changes (to automatically show in the TableView2).

TableView2

Modifier and Type	Field and Description
public static final TableView2.SpanType	BOTH_INVISIBLE Invisible cell situated in diagonal of a cell in a ROW_VISIBLE state.
public static final TableView2.SpanType	COLUMN_SPAN_INVISIBLE Invisible cell because a cell in a NORMAL_CELL state on the left is covering it.
public static final TableView2.SpanType	NORMAL_CELL Visible cell, can be a unique cell (no span) or the first one inside a column spanning cell.
public static final TableView2.SpanType	ROW_SPAN_INVISIBLE Invisible cell because a cell in a ROW_VISIBLE state on the top is covering it.
public static final TableView2.SpanType	ROW_VISIBLE Visible Cell but has some cells below in a ROW_SPAN_INVISIBLE state.

Modifier and Type	Method and Description
public static TableView2.SpanType	valueOf(String name)
public static TableView2.SpanType[]	values()

public Class TableView2<S>

Features

Fixing Rows and Columns

Row Headers

Cell editing

Filtering options

Features not supported

Sample

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public final Enum TableView2.SpanType

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail