darto_view 1.0.0 
darto_view: ^1.0.0 copied to clipboard
Template engine plugin for Darto. Configures views path and engine, enabling c.render() in route handlers.
darto_view #
Template engine plugin for Darto — pluggable, Hono-style renderer registration via middleware.
Ships with a Mustache engine out of the box. Any engine can be added by implementing the TemplateEngine interface.
Install #
dependencies:
darto: ^1.0.0
darto_view: ^1.0.0
mustache_template: ^2.0.0
path: ^1.9.0
Quick start #
import 'package:darto/darto.dart';
import 'package:darto_view/darto_view.dart';
void main() async {
final app = Darto();
// Register the engine once — all handlers can call c.render().
app.use(viewEngine(MustacheEngine(viewsPath: 'views')));
app.get('/', [], (c) => c.render('index', {
'title': 'Home',
'items': ['Routing', 'Middleware', 'Validation'],
}));
app.get('/about', [], (c) => c.render('about', {
'title': 'About',
'version': '1.0.0',
}));
await app.listen(3000);
}
Place templates in the views/ directory with a .mustache extension.
views/index.mustache:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>{{title}}</title>
</head>
<body>
<h1>{{title}}</h1>
<ul>
{{#items}}<li>{{.}}</li>{{/items}}
</ul>
</body>
</html>
viewEngine(engine) middleware #
Registers engine as the view renderer for every handler downstream.
Internally it calls c.setRender(layout) so c.render(templateName, data) works transparently.
// Global — all routes
app.use(viewEngine(MustacheEngine(viewsPath: 'views')));
// Scoped — only routes under /admin
app.mount('/admin/*', viewEngine(MustacheEngine(viewsPath: 'views/admin')));
MustacheEngine #
| Parameter | Type | Default | Description |
|---|---|---|---|
viewsPath |
String |
'views' |
Directory where .mustache files live |
Compiled templates are cached in memory after the first render — no disk I/O on subsequent requests.
Custom engines #
Implement TemplateEngine to plug in any template system:
import 'package:darto_view/darto_view.dart';
class JinjaEngine implements TemplateEngine {
final String viewsPath;
JinjaEngine({this.viewsPath = 'views'});
@override
Future<String> render(String template, Map<String, dynamic> data) async {
// load file, render with your preferred package, return HTML string
throw UnimplementedError();
}
}
// Register like any other engine
app.use(viewEngine(JinjaEngine(viewsPath: 'views')));
Direct HTML (no template) #
app.get('/ping', [], (c) => c.html('<h1>pong</h1>'));
API reference #
| Symbol | Description |
|---|---|
viewEngine(engine) |
Middleware — registers the engine on the context |
TemplateEngine |
Abstract class — implement to bring your own engine |
MustacheEngine({viewsPath}) |
Built-in Mustache engine with in-memory caching |
See also #
- darto — core framework
- mustache_template — Mustache for Dart
- examples/example_view_engine — working example
Metadata
Publisher
unverified uploader
Weekly Downloads
Metadata
Template engine plugin for Darto. Configures views path and engine, enabling c.render() in route handlers.
Homepage
Repository (GitHub)
View/report issues
License
unknown (license)
Dependencies
darto, mustache_template, path