Jinja 是 Jinja2 模板引擎的 Dart 实现,支持变量、表达式、控制结构和模板继承,可实现动态内容生成。它支持服务器端渲染,并能与 Web 框架良好集成。专为后端服务和 Web 应用设计,通过强大的模板功能帮助开发者将逻辑与展示分离。该包可在所有主要平台上运行,包括移动设备、Web 和桌面端。
适合场景
服务器端渲染
动态HTML生成
基于模板的内容创作
Web 应用程序布局
基于API的模板
多平台模板
主要特点
变量和表达式支持
控制结构(if、for)
模板继承
跨平台兼容性
轻量且快速
与 Dart 应用的轻松集成
适合对象
后端开发人员
全栈Web开发人员
模板驱动的应用程序
服务器端渲染的 Web 应用
基于 Dart 的 Web 框架
使用建议
不适用于客户端渲染
有限的文档
需要了解 Jinja2 语法
最适合服务器环境
无内置安全过滤器
可能需要对用户输入进行额外验证
原始 README
以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。
jinja
Jinja (3.x) server-side template engine port for Dart 3.
Variables, expressions, control structures and template inheritance.
Documentation
It is mostly similar to Jinja templates documentation, differences provided below.
work in progress.
Differences with Python version
Auto-escaping and related statements, filters and tests have been removed due to the impossibility of extending String.
Use the escape filter manually or escape values before passing them to the template.
The default filter compares values with null.
The defined and undefined tests compare values with null.
The map filter also compares values with null.
Use attribute and item filters for object.attribute and object[item] expressions.
If Environment({getAttribute}) is not passed, the getItem method will be used.
This allows you to use {{ map.key }} as an expression equivalent to {{ map['key'] }}.
String slices and negative indexes are not supported (list slicing [start:stop] with non-negative integers is supported).
Macro arguments without default values are required.
No FilterArgumentError error class.
No *args and **kwargs arguments.
No Template module.
work in progress
Dynamically invoked members (can increase the size of the JS output)
[], +, -, *, /, ~/, % operators
object.length getter
object.call getter
Function.apply(function, ...)
Example
import'package:jinja/jinja.dart';
// ...var environment = Environment(blockStart: '...', blockEnd: '...');
var template = environment.fromString('...source...');
print(template.render({'key': value}));
// or write directly to StringSink (IOSink, HttpResponse, ...)
template.renderTo(stringSink, {'key': value});
Contributions are welcome! Please open an issue or pull request on GitHub.
Look at the ToDo list and comments in the code for ideas on what to work on.
There are no strict rules, but please try to follow the existing code style.
As non-native English speaker and learner, I will be grateful for any
corrections in the documentation and code comments.
Support
Post issues and feature requests on the GitHub issue tracker.