ForgeTotal.js 5
fr

Total.js 5

Rendre des templates depuis du texte, des fichiers et des URL avec TEMPLATE

Total.js 5 · total5@0.0.19 templatescontenttangular Exécutée avec Total.js 5

TEMPLATE(source, model, [$]) rend un template Tangular et renvoie une promesse avec le texte. La source peut être :

  • un texte qui contient {{ ... }} : c'est le template lui-même
  • le nom d'un fichier du dossier templates : TEMPLATE('invoice', model) lit templates/invoice.html (un ~ au début fait du nom un chemin absolu)
  • une adresse http:// ou https://, que le code source de total5 télécharge (non vérifié sur cette page)

Ta est un autre nom de Tangular. Contrairement à Tangular.render(), le modèle est disponible sous le nom value : écrivez {{ value.name }}. Un fichier de template peut aussi contenir deux blocs que TEMPLATE lit et retire de la sortie : un <script> qui ajoute des helpers à Thelpers et un <script type="text/json"> avec le modèle par défaut, utilisé quand aucun modèle n'est passé.

templates/invoice.html
<script>
	Thelpers.money = function(value) {
		return (value || 0).toFixed(2) + ' EUR';
	};
</script>
<script type="text/json">{ "customer": "Anonymous", "total": 0 }</script>
<h1>Invoice for {{ value.customer }}</h1>
<p>Total: {{ value.total | money() }}</p>
controllers/documents.js
exports.install = function() {
	ROUTE('GET /text/', text);
	ROUTE('GET /file/', file);
	ROUTE('GET /default/', withdefault);
	ROUTE('GET /absolute/', absolute);
	ROUTE('GET /alias/', alias);
};

async function text($) {
	$.plain(await TEMPLATE('Hello {{ value.name }}!', { name: $.query.name || 'world' }));
}

async function file($) {
	$.plain(await TEMPLATE('invoice', { customer: 'Ana', total: 12.5 }));
}

function alias($) {
	$.json({ same: Ta === Tangular, rendered: Ta.render('{{ name }}', { name: 'x' }) });
}

async function absolute($) {
	const file = require('path').join(__dirname, '..', 'templates', 'invoice.html');
	$.plain(await TEMPLATE('~' + file, { customer: 'Eva', total: 1 }));
}

async function withdefault($) {
	$.plain(await TEMPLATE('invoice'));
}