Creer un template de vue

Un template de vue, ou gabarit est un fichier HTML comprenant la représentation d’un objet métier envoyée à l’utilisateur du logiciel.

Un template de vue est associé à une fonctionnalité du logiciel, appliquée à un objet métier.

Templates de vue par défaut
Le framework it.rocks propose par défaut des templates de vues standard pour les fonctionnalités suivantes. En voici des exemples (liste non exhaustive) :
- dataList.html : pour afficher une collection d’objets,
- delete.html : message de confirmation après une suppression ou un refus de suppression d’objet,
- deleteAndReplace.html : message de confirmation pour le supprime-et-remplace,
  - deleteAndReplace_done.html : lorsque le supprime-et-remplace est fait,
  - deleteAndReplace_error.html : lorsque le supprime-et-remplace a été annulé,
- output.html : l’affichage structuré d’un objet,
- removed.html : le message de confirmation d’élément retiré d’une Collection / Map,
- written.html : le message de confirmation lorsqu’un objet a été sauvegardé en base de données.
A défaut de template de vue spécialisée pour votre classe métier et votre fonctionnalité, le framework utilisera le template par défaut correspondant à la fonctionnalité.

Templates de vue spécialisés
Des exemples de vues spécialisées pour une classe métier dans le framework :
- menu/output.html : l’affichage du menu du logiciel surcharge pour un objet de classe Menu le template de vue par défaut output.html,
- user/display.html : affichage de l’utilisateur connecté et d’un bouton “déconnecter”,
- user/login.html : formulaire de connexion de l’utilisateur.
Vous pouvez donc :
- remplacer le template de vue par défaut pour une fonctionnalité par votre propre gabarit, adapté à votre classe métier,
- créer des templates de vue pour de nouvelles fonctionnalités appliquées à vos classes métier.
Arbre de recherche du template de vue

La vue HTML par défaut va rechercher différents templates, des plus spécialisés aux plus génériques.
Dans l’Application Movies les templates suivants sont recherchés lorsqu’on appelle cette URI : /ITRocks/Movies/Personality/1 Ou son équivalent : /ITRocks/Movies/Personality/1/output
- itrocks/movies/personality/output.html
- itrocks/movies/personality/output/output.html
- itrocks/movies/Personality_output.html
- itrocks/framework/personality/output.html
- itrocks/framework/personality/output/output.html
- itrocks/framework/Personality_output.html
- itrocks/framework/output/output.html
- itrocks/framework/widget/output/output.html
La recherche s’interrompt dès le premier de ces fichiers trouvé dans votre projet. Dans cet exemple c’est le template par défaut qui est utilisé, aucun template spécifique n’ayant été développé.

Vous pouvez obtenir la liste de toutes les classes de contrôleur, de vue, des templates, autorisées, en appelant votre URI en mode débogage instantanné :
/ITRocks/Movies/Personality/1?D&as_widget
as_wiget est conseillé pour ne voir la vue que de votre objet métier, et pas celles d’autres objets qui seraient dans toutes les pages votre application.

Contenu du template de vue

Votre gabarit HTML se développe comme une page HTML standard. Vous y remplacez vos données dynamiques par des expressions particulières qui seront remplacées par leurs valeurs par le moteur de templates.

Exemple

l’Application Examples propose une vue particulière pour l’affichage d’un client :
```
<!DOCTYPE html>
<html>
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
	<title>Client output template</title>
</head>
<body>

 
	<section class="client output window">
		<h2>
			<span>{title}</span> {?.}
			{/custom.html}
		</h2>
 
		{/general_buttons.html}
 
		{/output/object.html}
 
		<div class="quote">
			<q>{quote.0}</q>
			<address>{quote.1}</address>
		</div>
 
	</section>
 

</body>
</html>
```
Cette vue est similaire à la vue par défaut output.html, elle ajoute une section pour afficher une citation, préparée dans la classe de vue, en plus de l’objet métier client.

Voir aussi
- Introduction concernant les gabarits
- Référence gabarits
- Créer un modèle
- Créer une vue
- Créer un contrôleur

Wiki - 1 output

Notifications

Connected user

Creer un template de vue

Templates de vue par défaut

Templates de vue spécialisés

Arbre de recherche du template de vue

Contenu du template de vue

Exemple

Voir aussi