Listing row actions

In Mateu, listing rows are UI models.

They are not required to match your domain model.

A row can include:

fields to display
status indicators
contextual actions

Single action per row

public record ChangeRow(
        @Hidden String id,
        String page,
        String country,
        String language,
        Status status,
        ColumnAction action
) implements Identifiable {}

new ColumnAction("compare", "Compare")

Use ColumnAction when there is a single action for the row.

Multiple actions per row

public record ReleaseRow(
        String id,
        String site,
        String name,
        String user,
        String date,
        Status status,
        ColumnActionGroup action
) {}

new ColumnActionGroup(new ColumnAction[]{
        new ColumnAction("setAsBlue", "Set as blue"),
        new ColumnAction("setAsGreen", "Set as green"),
        new ColumnAction("preview", "Preview")
})

Use ColumnActionGroup when multiple actions are needed.

Action identifiers

Each action has an actionId:

new ColumnAction("compare", "Compare")

This id is used by Mateu to route the action to the backend.

Row identifiers

Rows should include an identifier:

@Hidden String id;

This allows Mateu to know which row triggered the action.

Status in rows

Status status

Status is rendered visually (badge-like), not as plain text.

Building rows in adapters

List<ChangeRow> rows = changes.stream()
    .map(dto -> new ChangeRow(
        dto.pageId(),
        dto.page(),
        dto.country(),
        dto.language(),
        new Status(mapStatus(dto.status()), dto.status().name()),
        new ColumnAction("compare", "Compare")
    ))
    .toList();

Rows are typically built in adapters or query services.

Key idea

Rows are UI representations, not domain entities.

They can include:

formatted data
derived fields
UI-specific constructs (actions, status)

When to use

Use row actions when:

actions depend on the specific row
you need contextual operations
actions should be visible directly in the list

Summary

Type	Use when
`ColumnAction`	A single action applies to every row
`ColumnActionGroup`	Multiple contextual actions per row
`@Hidden String id`	Required so Mateu knows which row triggered the action
`Status`	Render a field as a visual badge rather than plain text

Rows are UI models, not domain entities. They can include formatted data, derived fields, and UI-specific constructs alongside the action controls.

Full control with Crud — when you need separate models for filters, rows, views, and forms
Customizing CRUD and listings — the full progressive customization ladder
Golden example: Orders, Customers and Order lines — a complete example showing row actions in context