Comece com o Total.js

Total.js 5 · total5@0.0.19 guideinstallfirst app Executada com o Total.js 5

O Total.js 5 é o pacote npm total5. Precisa do Node.js (os exemplos deste site correm no Node.js 24) e de uma pasta vazia. Crie o projeto e instale o pacote:

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

O script de arranque é um ficheiro chamado index.js na raiz do projeto. Carrega o framework e inicia o servidor:

require('total5');

Total.run({ port: 8000 });

Este é todo o código que escreve para arrancar. Os ficheiros das pastas do projeto (veja a página sobre a estrutura do projeto) são carregados automaticamente. Crie estes três ficheiros.

Um controlador declara as rotas. ROUTE('GET /') sem manipulador mostraria a vista com o mesmo nome; aqui o manipulador renderiza views/index.html com um modelo:

controllers/index.js

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

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

Uma ação tem a sua própria validação. A rota acima executa Greet/say com o corpo JSON do pedido, e o framework rejeita um corpo que não corresponda a input:

definitions/greet.js

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

Uma vista é HTML com blocos @{...}. views/layout.html envolve cada vista e @{body} é o lugar da 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>

Inicie a aplicação com node index.js. No modo predefinido debug, a aplicação reinicia quando altera um ficheiro e apresenta o seu endereço no terminal. Para o modo release, utilize node index.js --release. O guia dos modos de execução explica as diferenças.