Inizia con il Total.js

Total.js 5 · total5@0.0.19 guideinstallfirst app Eseguita con Total.js 5

Total.js 5 è il pacchetto npm total5. Ti servono Node.js (gli esempi di questo sito girano su Node.js 24) e una cartella vuota. Crea il progetto e installa il pacchetto:

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

Lo script di avvio è un file chiamato index.js nella radice del progetto. Carica il framework e avvia il server:

require('total5');

Total.run({ port: 8000 });

Questo è tutto il codice che scrivi per avviare. I file nelle cartelle del progetto (vedi la pagina sulla struttura del progetto) vengono caricati automaticamente. Crea questi tre file.

Un controller dichiara le route. ROUTE('GET /') senza handler mostrerebbe la vista con lo stesso nome; qui l'handler renderizza views/index.html con un modello:

controllers/index.js

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

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

Un'azione ha la propria validazione. La route qui sopra esegue Greet/say con il corpo JSON della richiesta, e il framework rifiuta un corpo che non corrisponde a input:

definitions/greet.js

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

Una vista è HTML con blocchi @{...}. views/layout.html avvolge ogni vista e @{body} è il posto della vista:

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>

Avvia l’applicazione con node index.js. Nella modalità predefinita debug, l’applicazione si riavvia quando modifichi un file e mostra il proprio indirizzo nel terminale. Per la modalità release, usa node index.js --release. La guida alle modalità di esecuzione descrive le differenze.