JTable

Overview

JTable is a feature-rich table component built on JavaFX TableView with advanced capabilities including:

Checkbox selection with header “select all” control
Built-in search and filtering across columns
Custom cell renderers for rich content
Row actions column with custom buttons/controls
Bulk actions toolbar for multi-row operations
CSV export functionality
Pagination with customizable items per page
Infinite scroll support
Empty state customization
Striped and dense visual modes

Constructor

JTable<T>()

constructor

Creates a new generic table for type T.

Basic Usage

JTable<User> table = new JTable<>();
table.setCheckable(true);
table.setSearchable(true);
table.setStriped(true);
table.addColumn("Name", "name");
table.addColumn("Email", "email");
table.addColumn("Role", "role", user -> new JChip(user.getRole()));
table.setRowActions((user, box) -> {
    JButton editBtn = new JButton("Edit");
    editBtn.setOnAction(e -> editUser(user));
    box.getChildren().add(editBtn);
});
table.setItems(userData);

Column Configuration

addColumn(title, property)

TableColumn<T, V>

Adds a sortable column with the specified title and property name.

Show Parameters

title (String): Column header text
property (String): JavaBean property name for cell value binding

addColumn(title, property, sortable)

TableColumn<T, V>

Adds a column with control over sortability.

Show Parameters

title (String): Column header text
property (String): JavaBean property name
sortable (boolean): Whether the column can be sorted

addColumn(title, property, renderer)

TableColumn<T, V>

Adds a column with a custom cell renderer.

Show Parameters

title (String): Column header text
property (String): JavaBean property name
renderer (Function<T, Node>): Function that returns a JavaFX Node for each row item

addColumn(title, property, sortable, renderer)

TableColumn<T, V>

Adds a column with custom renderer and sortability control.

Show Parameters

title (String): Column header text
property (String): JavaBean property name
sortable (boolean): Whether the column can be sorted
renderer (Function<T, Node>): Custom cell renderer function

Checkable Mode

setCheckable(boolean)

void

Enables or disables checkbox selection mode. When enabled, adds a checkbox column with header “select all” control.

isCheckable()

boolean

Returns whether checkbox mode is enabled.

getCheckedItems()

ObservableList<T>

Returns the list of currently checked items.

getCheckedIndices()

List<Integer>

Returns the indices of checked items in the original data list.

clearChecks()

void

Clears all checkbox selections and resets header checkbox state.

setOnCheckChange(callback)

void

Sets a callback that fires when the checked items selection changes.

Show Parameters

callback (Consumer<List<T>>): Callback receiving the list of checked items

Search and Filter

setSearchable(boolean)

void

Enables or disables the search bar. Automatically filters across all column properties.

isSearchable()

boolean

Returns whether search mode is enabled.

setSearchPlaceholder(placeholder)

void

Sets the placeholder text for the search field (default: “Buscar…”).

Show Parameters

placeholder (String): Search field placeholder text

Row Actions

setRowActions(actionsFactory)

void

Sets a factory function to create action buttons/controls for each row.

Show Parameters

actionsFactory (BiConsumer<T, HBox>): Function receiving the row item and an HBox to populate with action controls

table.setRowActions((user, box) -> {
    JButton editBtn = new JButton("Edit");
    JButton deleteBtn = new JButton("Delete");
    editBtn.setOnAction(e -> editUser(user));
    deleteBtn.setOnAction(e -> deleteUser(user));
    box.getChildren().addAll(editBtn, deleteBtn);
});

Row Click

setOnRowClick(handler)

void

Sets a callback that fires when a table row is clicked.

Show Parameters

handler (Consumer<T>): Callback receiving the clicked row item

Bulk Actions

setBulkActionsEnabled(boolean)

void

Enables or disables the bulk actions toolbar (requires checkable mode).

setOnBulkDelete(handler)

void

Sets a callback for bulk delete action and automatically enables bulk actions.

Show Parameters

handler (Consumer<List<T>>): Callback receiving the list of checked items to delete

Data Management

setItems(items)

void

Sets the table’s data source.

Show Parameters

items (ObservableList<T>): The observable list of items to display

getItems()

ObservableList<T>

Returns the current items list.

setItemsPerPage(items)

void

Sets the number of items per page for pagination (default: 10).

Show Parameters

items (int): Number of items per page

addItem(item)

void

Adds a single item to the table.

Show Parameters

item (T): The item to add

removeItem(item)

void

Removes a single item from the table and checked items list.

Show Parameters

item (T): The item to remove

removeItems(items)

void

Removes multiple items from the table and checked items list.

Show Parameters

items (List<T>): The items to remove

refresh()

void

Refreshes the table display, reapplying filters and updating the view.

Empty State

setEmptyText(text)

void

Sets the text displayed when the table has no data.

Show Parameters

text (String): Empty state message

setEmptyGraphic(graphic)

void

Sets a custom graphic/icon for the empty state.

Show Parameters

graphic (Node): Custom graphic node

Visual Modes

setStriped(boolean)

void

Enables or disables striped row styling (alternating row colors).

isStriped()

boolean

Returns whether striped mode is enabled.

setDense(boolean)

void

Enables or disables dense mode (compact row spacing).

isDense()

boolean

Returns whether dense mode is enabled.

Status Bar

setStatusBarEnabled(boolean)

void

Enables or disables the status bar showing “Showing X to Y of Z results”.

Pagination

setPaginationVisible(boolean)

void

Shows or hides the pagination controls.

Show Parameters

visible (boolean): Whether pagination should be visible

getPagination()

JPagination

Returns the underlying JPagination component for advanced control.

Infinite Scroll

setOnScrollBottom(action)

void

Sets a callback that fires when the user scrolls to the bottom of the table.

Show Parameters

action (Runnable): Callback to execute when scroll reaches bottom

CSV Export

exportToCSV(file)

void

Exports all table data to a CSV file.

Show Parameters

file (File): Destination file for the CSV export

File csvFile = new File("users.csv");
table.exportToCSV(csvFile);

Access to Underlying Components

getTableView()

TableView<T>

Returns the underlying JavaFX TableView for advanced customization.

Core

Button Components

Input Components

Form Controls

Layout Components

Navigation Components

Feedback Components

Data Display

Typography

Advanced Components

Overview

Constructor

Basic Usage

Column Configuration

Checkable Mode

Search and Filter

Row Actions

Row Click

Bulk Actions

Data Management

Empty State

Visual Modes

Status Bar

Infinite Scroll

CSV Export

Access to Underlying Components

Build docs developers (and LLMs) love

Core

Button Components

Input Components

Form Controls

Layout Components

Navigation Components

Feedback Components

Data Display

Typography

Advanced Components

​Overview

​Constructor

​Basic Usage

​Column Configuration

​Checkable Mode

​Search and Filter

​Row Actions

​Row Click

​Bulk Actions

​Data Management

​Empty State

​Visual Modes

​Status Bar

​Pagination

​Infinite Scroll

​CSV Export

​Access to Underlying Components

Build docs developers (and LLMs) love

Overview

Constructor

Basic Usage

Column Configuration

Checkable Mode

Search and Filter

Row Actions

Row Click

Bulk Actions

Data Management

Empty State

Visual Modes

Status Bar

Pagination

Infinite Scroll

CSV Export

Access to Underlying Components