ForgeDokumentacja
pl

Dokumentacja

Zacznij od Total.js

Total.js 5 · total5@0.0.19 guideinstallfirst app Uruchomiono z Total.js 5

Total.js 5 to pakiet npm total5. Potrzebujesz Node.js (przykłady na tej stronie działają na Node.js 24) i pustego folderu. Utwórz projekt i zainstaluj pakiet:

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

Skrypt startowy to plik o nazwie index.js w katalogu głównym projektu. Ładuje framework i uruchamia serwer:

require('total5');

Total.run({ port: 8000 });

To cały kod, który piszesz, aby wystartować. Pliki w folderach projektu (zobacz stronę o strukturze projektu) są ładowane automatycznie. Utwórz te trzy pliki.

Kontroler deklaruje trasy. ROUTE('GET /') bez obsługi pokazałby widok o tej samej nazwie; tutaj obsługa renderuje views/index.html z modelem:

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

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

Akcja ma własną walidację. Powyższa trasa uruchamia Greet/say z treścią JSON żądania, a framework odrzuca treść niezgodną z input:

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

Widok to HTML z blokami @{...}. views/layout.html otacza każdy widok, a @{body} to miejsce widoku:

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>

Uruchom aplikację poleceniem node index.js. W domyślnym trybie debug aplikacja uruchamia się ponownie po zmianie pliku i wyświetla swój adres w terminalu. Tryb release uruchomisz poleceniem node index.js --release. Różnice opisuje przewodnik po trybach uruchamiania.