ForgeDokumentation
sv

Dokumentation

Börja med Total.js

Total.js 5 · total5@0.0.19 guideinstallfirst app Körd med Total.js 5

Total.js 5 är npm-paketet total5. Du behöver Node.js (exemplen på den här webbplatsen körs på Node.js 24) och en tom mapp. Skapa projektet och installera paketet:

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

Startskriptet är en fil som heter index.js i projektets rot. Det laddar ramverket och startar servern:

require('total5');

Total.run({ port: 8000 });

Det är all kod du skriver för att starta. Filerna i projektets mappar (se sidan om projektstrukturen) laddas automatiskt. Skapa dessa tre filer.

En controller deklarerar routerna. ROUTE('GET /') utan hanterare skulle visa vyn med samma namn; här renderar hanteraren views/index.html med en modell:

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

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

En åtgärd har sin egen validering. Routen ovan kör Greet/say med JSON-kroppen från begäran, och ramverket avvisar en kropp som inte matchar input:

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

En vy är HTML med @{...}-block. views/layout.html omsluter varje vy och @{body} är vyns plats:

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>

Starta programmet med node index.js. I standardläget debug startar programmet om när du ändrar en fil och visar sin adress i terminalen. Använd node index.js --release för läget release. Guiden till körlägen beskriver skillnaderna.