66 lines
1.6 KiB
Markdown
66 lines
1.6 KiB
Markdown
# flash-ext-view-thymeleaf
|
|
|
|
Opinionated Thymeleaf SSR extension for Flash.
|
|
|
|
This module keeps Thymeleaf semantics front and center:
|
|
|
|
- `ThymeleafExtension`
|
|
- `ThymeleafHandler`
|
|
- `@Template` and `@Fragment`
|
|
- `ViewModel` from `flash-ext-view-core`
|
|
- `global.*` reserved namespace
|
|
|
|
The extension uses Thymeleaf-native patterns (`template` names resolved by prefix/suffix,
|
|
fragment selection via `template :: fragment`) while keeping Flash boot-time fail-fast checks.
|
|
|
|
## Quick Start
|
|
|
|
```java
|
|
import dev.relism.extension.FlashApp;
|
|
import dev.relism.ext.view.core.ViewModel;
|
|
import dev.relism.ext.view.thymeleaf.*;
|
|
|
|
FlashApp.create(8080)
|
|
.install(new ThymeleafExtension()
|
|
.addGlobal("appName", req -> "Flash")
|
|
.addGlobal("requestPath", req -> req.path()))
|
|
.scan("com.example.web")
|
|
.startAndBlock();
|
|
```
|
|
|
|
```java
|
|
import dev.relism.ext.view.core.ViewModel;
|
|
import dev.relism.ext.view.thymeleaf.*;
|
|
import dev.relism.routing.GET;
|
|
|
|
@GET("/")
|
|
@Template("pages/home")
|
|
public final class HomePage extends ThymeleafHandler {
|
|
@Override
|
|
public ViewModel render(dev.relism.models.Request req) {
|
|
return ViewModel.of("title", "Home");
|
|
}
|
|
}
|
|
```
|
|
|
|
## Fragment Example
|
|
|
|
```java
|
|
@GET("/users/rows")
|
|
@Fragment(template = "fragments/users", value = "rows")
|
|
public final class UserRows extends ThymeleafHandler {
|
|
@Override
|
|
public ViewModel render(dev.relism.models.Request req) {
|
|
return ViewModel.of("users", List.of());
|
|
}
|
|
}
|
|
```
|
|
|
|
## Docs
|
|
|
|
- `docs/architecture.md`
|
|
- `docs/handlers.md`
|
|
- `docs/model-and-globals.md`
|
|
- `docs/fragments.md`
|
|
- `docs/performance.md`
|