Začněte s Total.js

Total.js 5 · total5@0.0.19 guideinstallfirst app Spuštěno s Total.js 5

Total.js 5 je npm balíček total5. Potřebujete Node.js (příklady na tomto webu běží na Node.js 24) a prázdnou složku. Vytvořte projekt a nainstalujte balíček:

mkdir hello && cd hello
npm init -y
npm install total5

Spouštěcí skript je soubor s názvem index.js v kořenu projektu. Načte framework a spustí server:

require('total5');

Total.run({ port: 8000 });

To je veškerý kód, který pro start napíšete. Soubory ve složkách projektu (viz stránka o struktuře projektu) se načtou automaticky. Vytvořte tyto tři soubory.

Kontroler deklaruje routy. ROUTE('GET /') bez obsluhy by zobrazil pohled se stejným názvem; zde obsluha vykreslí views/index.html s modelem:

controllers/index.js

exports.install = function() {
	ROUTE('GET /', home);
	ROUTE('POST /greet/ --> *Greet/say');
};

function home($) {
	$.view('index', { title: 'Hello Total.js' });
}

Akce má vlastní validaci. Uvedená routa spustí Greet/say s JSON tělem požadavku a framework odmítne tělo, které neodpovídá input:

definitions/greet.js

NEWACTION('Greet/say', {
	name: 'Say hello',
	input: '*name:String',
	action: function($, model) {
		$.callback({ message: 'Hello, ' + model.name + '!' });
	}
});

Pohled je HTML s bloky @{...}. views/layout.html obaluje každý pohled a @{body} je místo pohledu:

views/layout.html

<!DOCTYPE html>
<html>
<head><meta charset="utf-8" /><title>Hello</title></head>
<body>@{body}</body>
</html>

views/index.html

<h1>@{model.title}</h1>

Spusťte aplikaci příkazem node index.js. Ve výchozím režimu debug se aplikace po změně souboru restartuje a vypíše svou adresu do terminálu. Režim release spustíte příkazem node index.js --release. Rozdíly popisuje průvodce režimy spouštění.