Documentation : Vues

Présentation

La vue est la couche logicielle qui s'occupe de mettre en forme les données qui sont renvoyées par le serveur après les traitements.

Par défaut, Temma utilise le moteur de template Smarty, ce qui permet de générer très facilement des pages HTML à partir des données exportées par les contrôleurs.

Temma fournit aussi nativement une vue servant à générer des flux JSON, ce qui peut s'avérer très pratique dans le cadre de communications AJAX.

Utilisation d'une vue avec template

Certaines vues utilisent des templates pour traiter les données et générer les flux sortants. Comme vu dans l'introduction, Temma va chercher un fichier dont le nom correspond à celui de l'action demandée (avec l'extension ".tpl"), placé dans un répertoire dont le nom est celui du contrôleur exécuté ; le tout placé dans le répertoire templates/ du projet.

Pour contourner ce comportement automatique, une action peut spécifier le template à utiliser :

class UserController extends \Temma\Controller {
    public function execList($type=null) {
        // traitements...

        // redéfinition du template dans un cas particulier
        if ($type == 'all')
            $this->template('user/listAll.tpl');
        // dans les autres cas, le template sera "user/list.tpl"
    }
}
						
Définition de la vue

Il est possible de spécifier la vue à utiliser, individuellement pour chaque action.

Voici un exemple d'action dont les données sont exportées au format JSON :

class UserController extends \Temma\Controller {
    public function execGet($id) {
        // traitements...

        // enregistrement des données qui vont être envoyées dans le flux JSON
        $this->set('json', $data);

        // définition de la vue à utiliser
        $this->view('\Temma\Views\JsonView');
    }
}
						
Configuration de la vue par défaut

Vous avez la possibilité de changer la vue par défaut, en modifiant le fichier de configuration temma.json.

Par exemple, si vous voulez utiliser la vue TemmaPhpView à la place de la vue Smarty habituelle, il faut la télécharger (voir la documentation de cette extension) puis ajouter la directive defaultView à la configuration du site (fichier etc/temma.json) :

{
    "application": {
        // configuration habituelle (dsn, defaultController, ...)

        // configuration de la vue par défaut
        "defaultView": "\\Temma\\Views\\PhpView"
    }
}