ForgeDokumentáció
hu

Dokumentáció

Kezdjük a Total.js-vel

Total.js 5 · total5@0.0.19 guideinstallfirst app Total.js 5-tel lefuttatva

A Total.js 5 az total5 npm-csomag. Szükséged van Node.js-re (az oldal példái Node.js 24-en futnak) és egy üres mappára. Hozd létre a projektet és telepítsd a csomagot:

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

Az indítószkript a projekt gyökerében lévő index.js nevű fájl. Betölti a keretrendszert és elindítja a szervert:

require('total5');

Total.run({ port: 8000 });

Ennyi az egész kód, amit az induláshoz írnod kell. A projekt mappáiban lévő fájlok (lásd a projektstruktúra oldalt) automatikusan betöltődnek. Hozd létre ezt a három fájlt.

A vezérlő deklarálja az útvonalakat. A kezelő nélküli ROUTE('GET /') az azonos nevű nézetet jelenítené meg; itt a kezelő a views/index.html-t rendereli egy modellel:

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

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

Egy művelet saját validációval rendelkezik. A fenti útvonal a kérés JSON törzsével futtatja a Greet/say-t, a keretrendszer pedig elutasítja az input-nak nem megfelelő törzset:

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

A nézet @{...} blokkokat tartalmazó HTML. A views/layout.html minden nézetet körbevesz, a @{body} pedig a nézet helye:

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>

Indítsa el az alkalmazást a node index.js paranccsal. Az alapértelmezett debug módban az alkalmazás fájlmódosítás után újraindul, és kiírja a címét a terminálba. A release módhoz használja a node index.js --release parancsot. A futtatási módok útmutatója ismerteti a különbségeket.