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

.map(dto -> new ChangeRow(
        dto.pageId(),
        dto.page(),
        dto.country(),
        dto.language(),
        new Status(mapStatus(dto.status()), dto.status().name()),
        new ColumnAction("compare", "Compare")
))

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.

---

Next

• Full control with CrudOrchestrator — 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