# Sablonok renderelése szövegből, fájlokból és URL-ekből a TEMPLATE-tel

> A TEMPLATE() segítségével renderelhet egy Tangular sablont, amely lehet szöveg, a sablonmappa egy fájlja vagy egy URL, saját helperekkel és alapértelmezett modellel.

Framework: total5
Product: Total.js 5 (total5@0.0.19)
Language: hu
Content-SHA256: efde910aa8733dffddb79496fefd269eff7153fa632bf04c8313b4157326ad63
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: total5-installed@total5@0.0.19
Review: not-recorded

A `TEMPLATE(source, model, [$])` egy Tangular sablont renderel, és **promise**-t ad vissza a szöveggel. A `source` lehet:

- egy `{{ ... }}`-t tartalmazó szöveg: ez maga a sablon
- a `templates` mappa egy fájljának neve: a `TEMPLATE('invoice', model)` a `templates/invoice.html` fájlt olvassa (az elején álló `~` a nevet abszolút úttá teszi)
- egy `http://` vagy `https://` cím, amelyet a `total5` forráskódja letölt (ezen az oldalon nem ellenőrizve)

A `Ta` a `Tangular` másik neve. A `Tangular.render()`-rel ellentétben a modell **`value`** néven érhető el: írja azt, hogy `{{ value.name }}`. Egy sablonfájl két olyan blokkot is hordozhat, amelyet a `TEMPLATE` beolvas és eltávolít a kimenetből: egy `<script>`-et, amely helpereket ad a `Thelpers`-hez, és egy `<script type="text/json">`-t az alapértelmezett modellel, amelyet akkor használ, ha nem adnak át modellt.

```html 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>
```

```js 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'));
}
```