2.5 KiB
2.5 KiB
Angel3 Jael
Installation
In your pubspec.yaml:
dependencies:
angel3_jael: ^4.2.0
Usage
Just like mustache and other renderers, configuring Angel to use
Jael is as simple as calling app.configure:
import 'package:angel3_framework/angel3_framework.dart';
import 'package:angel3_jael/angel3_jael.dart';
import 'package:file/file.dart';
AngelConfigurer myPlugin(FileSystem fileSystem) {
return (Angel app) async {
// Connect Jael to your server...
await app.configure(
jael(fileSystem.directory('views')),
);
};
}
package:angel3_jael supports caching views, to improve server performance. You might not want to enable this in development, so consider setting the flag to app.isProduction:
jael(viewsDirectory, cacheViews: app.isProduction);
Keep in mind that this package uses package:file, rather than dart:io.
The following is a basic example of a server setup that can render Jael templates from a directory named views:
import 'package:angel3_framework/angel3_framework.dart';
import 'package:angel3_jael/angel3_jael.dart';
import 'package:file/local.dart';
import 'package:logging/logging.dart';
void main() async {
var app = Angel();
var fileSystem = const LocalFileSystem();
await app.configure(
jael(fileSystem.directory('views')),
);
// Render the contents of views/index.jael
app.get('/', (res) => res.render('index', {'title': 'ESKETTIT'}));
app.use(() => throw AngelHttpException.notFound());
app.logger = Logger('angel')
..onRecord.listen((rec) {
print(rec);
if (rec.error != null) print(rec.error);
if (rec.stackTrace != null) print(rec.stackTrace);
});
var server = await app.startServer(null, 3000);
print('Listening at http://${server.address.address}:${server.port}');
}
To apply additional transforms to parsed documents, provide a set of patch functions, like in package:jael3_preprocessor.