On This Page

State, actions and fields

Mateu UIs are built from a small set of concepts.

State (fields)

Fields represent UI state.

String name;
boolean active;

By default, Mateu infers the rendered control from the field type.

Use @Stereotype when you want to override that default rendering type.

Actions represent behavior triggered by the user.

They can be defined as:

Methods annotated with @Toolbar are rendered in the toolbar, typically in the top-right area.

@Toolbar
public void refresh() {
  // ...
}

Methods annotated with @Button are rendered in the form action area, typically at the bottom.

@Button
public void save() {
  // ...
}

Runnable fields annotated with @Button behave like regular form fields, so they can be positioned inline inside the form.

@Button
Runnable generate = () -> {};

Actions can be configured declaratively using @Action.

Standard Bean Validation annotations are automatically enforced in the UI.

Triggers define when actions run.

Rules define how the UI changes dynamically in the browser.

Actions can return: