Commencez par Total.js

Total.js 5 · total5@0.0.19 guideinstallfirst app Exécutée avec Total.js 5

Total.js 5 est le paquet npm total5. Il vous faut Node.js (les exemples de ce site tournent sur Node.js 24) et un dossier vide. Créez le projet et installez le paquet :

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

Le script de démarrage est un fichier nommé index.js à la racine du projet. Il charge le framework et démarre le serveur :

require('total5');

Total.run({ port: 8000 });

C'est tout le code à écrire pour démarrer. Les fichiers des dossiers du projet (voir la page sur la structure du projet) sont chargés automatiquement. Créez ces trois fichiers.

Un contrôleur déclare les routes. ROUTE('GET /') sans gestionnaire afficherait la vue du même nom ; ici le gestionnaire rend views/index.html avec un modèle :

controllers/index.js

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

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

Une action a sa propre validation. La route ci-dessus exécute Greet/say avec le corps JSON de la requête, et le framework rejette un corps qui ne correspond pas à input :

definitions/greet.js

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

Une vue est du HTML avec des blocs @{...}. views/layout.html enveloppe chaque vue et @{body} est l'emplacement de la vue :

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>

Démarrez l’application avec node index.js. En mode debug (par défaut), elle redémarre lorsque vous modifiez un fichier et affiche son adresse dans le terminal. Pour le mode release, utilisez node index.js --release. Le guide des modes d’exécution explique les différences.