Orientação gerada a partir de informações públicas. Apenas para referência.
Jinja é uma implementação Dart do motor de template Jinja2, permitindo a geração de conteúdo dinâmico com variáveis, expressões, estruturas de controle e herança de templates. Suporta renderização do lado do servidor e se integra bem com frameworks web. Projetado para uso em serviços backend e aplicações web, permite que desenvolvedores separem lógica da apresentação usando recursos avançados de templating. O pacote funciona em todas as principais plataformas, incluindo móvel, web e desktop.
Casos de uso
Renderização do lado do servidor
Geração dinâmica de HTML
Criação de conteúdo baseada em modelos
Layouts de aplicativos web
modelos baseados em API
Modelagem multiplataforma
Principais recursos
Suporte a variáveis e expressões
Estruturas de controle (if, for)
herança de modelo
Compatibilidade multiplataforma
Leve e rápido
Integração fácil com aplicativos Dart
Indicado para
desenvolvedores de backend
Desenvolvedores web full-stack
Aplicações orientadas por modelo
Aplicativos da web renderizados no servidor
Frameworks web baseados em Dart
Considerações
Não destinado à renderização do lado do cliente
Documentação limitada
Requer conhecimento sobre a sintaxe do Jinja2
Mais adequado para ambientes de servidor
Sem filtros de segurança embutidos
Pode ser necessário validação adicional para a entrada do usuário
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
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.