diff --git a/source/views.rst b/source/views.rst index 7cff945..b96ef93 100644 --- a/source/views.rst +++ b/source/views.rst @@ -3,6 +3,8 @@ Contrôleurs =========== Dans un *pattern* MVC classique, la traduction immédiate du **contrôleur** est une **vue**. Et comme on le verra par la suite, la **vue** est en fait le **template**. -Les vues agrègent donc les informations à partir d'un des composants et les font transiter vers un autre. En d'autres mots, la vue sert de pont entre deux composants. +Les vues agrègent donc les informations à partir d'un des composants et les font transiter vers un autre. En d'autres mots, la vue sert de pont entre les données gérées par la base et l'interface utilisateur. +.. include:: views/templates.rst +.. include:: views/views.rst .. include:: views/urls.rst diff --git a/source/views/my-first-wishlists.png b/source/views/my-first-wishlists.png new file mode 100644 index 0000000..eacd331 Binary files /dev/null and b/source/views/my-first-wishlists.png differ diff --git a/source/views/templates.rst b/source/views/templates.rst new file mode 100644 index 0000000..5aabf14 --- /dev/null +++ b/source/views/templates.rst @@ -0,0 +1,71 @@ +********* +Templates +********* + +Avant de commencer à interagir avec nos données au travers de listes, formulaires et IHM sophistiquées, quelques mots sur les templates: il s'agit en fait de *squelettes* de présentation, recevant en entrée un dictionnaire contenant des clés-valeurs et ayant pour but de les afficher dans le format que vous définirez. En intégrant un ensemble de *tags*, cela vous permettra de greffer les données reçues en entrée dans un patron prédéfini. + +Une page HTML basique ressemble à ceci: + +.. code-block:: html + + + + + + + + + +

Hello world!

+ + + +Notre première vue permettra de récupérer la liste des objets de type ``Wishlist`` que nous avons définis dans le fichier ``wish/models.py``. Supposez que cette liste soit accessible *via* la clé ``wishlists`` d'un dictionnaire passé au template. Elle devient dès lors accessible grâce aux tags ``{% for wishlist in wishlists %}``. A chaque tour de boucle, on pourra directement accéder à la variable ``{{ wishlist }}``. De même, il sera possible d'accéder aux propriétés de cette objet de la même manière: ``{{ wishlist.id }}``, ``{{ wishlist.description }}``, ... et d'ainsi respecter la mise en page que nous souhaitons. + +En reprenant l'exemple de la page HTML définie ci-dessus, on pourra l'agrémenter de la manière suivante: + +.. code-block:: html + + + + + + + + + +

Mes listes de souhaits

+ + + + + +Vous pouvez déjà copié ce contenu dans un fichier ``templates/wsh/list.html``, on en aura besoin par la suite. + +Structure et configuration +========================== + +Il est conseillé que les templates respectent la structure de vos différentes applications, mais dans un répertoire à part. Par convention, nous les placerons dans un répertoire ``templates``. La hiérarchie des fichiers devient alors celle-ci: + +.. code--block:: bash + + $ tree templates/ + templates/ + └── wish + └── list.html + +Par défaut, Django cherchera les templates dans les répertoirer d'installation. Vous devrez vous éditer le fichier ``gwift/settings.py`` et ajouter, dans la variable ``TEMPLATES``, la clé ``DIRS`` de la manière suivante: + +.. code-block:: python + + TEMPLATES = [ + { + ... + 'DIRS': [ 'templates' ], + ... + }, + ] diff --git a/source/views/views.rst b/source/views/views.rst new file mode 100644 index 0000000..0dc522f --- /dev/null +++ b/source/views/views.rst @@ -0,0 +1,146 @@ +**** +Vues +**** + +Une vue correspond à un contrôleur dans le pattern MVC. Tout ce que vous pourrez définir au niveau du fichier ``views.py`` fera le lien entre le modèle stocké dans la base de données et ce avec quoi l'utilisateur pourra réellement interagir (le ``template``). + +Chaque vue peut etre représentée de deux manières: soit par des fonctions, soit par des classes. Le comportement leur est propre, mais le résultat reste identique. Le lien entre l'URL à laquelle l'utilisateur accède et son exécution est faite au travers du fichier ``gwift/urls.py``, comme on le verra par la suite. + +Function Based Views +==================== + +Les fonctions (ou ``FBV`` pour *Function Based Views*) permettent une implémentation classique des contrôleurs. Au fur et à mesure de votre implémentation, on se rendra compte qu'il y a beaucoup de répétitions dans ce type d'implémentation: elles ne sont pas obsolètes, mais dans certains cas, il sera préférable de passer par les classes. + +Pour définir la liste des ``WishLists`` actuellement disponibles, on précédera de la manière suivante: + + 1. Définition d'une fonction qui va récupérer les objets de type ``WishList`` dans notre base de données. La valeur de retour sera la construction d'un dictionnaire (le *contexte*) qui sera passé à un template HTML. On démandera à ce template d'effectuer le rendu au travers de la fonction ``render``, qui est importée par défaut dans le fichier ``views.py``. + 2. Construction d'une URL qui permettra de lier l'adresse à l'exécution de la fonction. + 3. Définition du squelette. + +Définition de la fonction +------------------------- + +.. code-block:: python + + # wish/views.py + + from django.shortcuts import render + from .models import Wishlist + + def wishlists(request): + w = Wishlist.objects.all() + return render(request, 'wish/list.html',{ 'wishlists': w }) + +Construction de l'URL +--------------------- + +.. code-block:: python + + # gwift/urls.py + + from django.conf.urls import include, url + from django.contrib import admin + + from wish import views as wish_views + + urlpatterns = [ + url(r'^admin/', include(admin.site.urls)), + url(r'^$', wish_views.wishlists, name='wishlists'), + ] + +Définition du squelette +----------------------- + +A ce stade, vérifiez que la variable ``TEMPLATES`` est correctement initialisée dans le fichier ``gwift/settings.py`` et que le fichier ``templates/wish/list.html`` ressemble à ceci: + +.. code-block:: html + + + + + + + + + +

Mes listes de souhaits

+ + + + +Exécution +--------- + +A présent, ajoutez quelques listes de souhaits grâce à un *shell*, puis lancez le serveur: + +.. code-block:: shell + + $ python manage.py shell + >>> from wish.models import Wishlist + >>> Wishlist.create('Décembre', "Ma liste pour les fêtes de fin d'année") + + >>> Wishlist.create('Anniv 30 ans', "Je suis vieux! Faites des dons!") + + +Lancez le serveur grâce à la commande ``python manage.py runserver``, ouvrez un navigateur quelconque et rendez-vous à l'adresse `http://localhost:8000 `_. Vous devriez obtenir le résultat suivant: + +.. image:: views/my-first-wishlists.png + :align: center + +Rien de très sexy, aucune interaction avec l'utilisateur, très peu d'utilisation des variables contextuelles, mais c'est un bon début! =) + +Class Based Views +================= + +Les classes, de leur côté, implémente le *pattern* objet et permettent d'arriver facilement à un résultat en très peu de temps, parfois même en définissant simplement quelques attributs, et rien d'autre. Pour l'exemple, je vais définir deux classes qui donnent exactement le même résultat que la fonction ``wishlists`` ci-dessus. Une première fois en utilisant une classe générique vierge, et ensuite en utilisant une classe de type ``ListView``. + +Classe générique +---------------- + +blah + +ListView +-------- + +Les classes génériques implémentent un aspect bien particulier de la représentation d'un modèle, en utilisant très peu d'attributs. Les principales classes génériques sont de type ``ListView``, [...]. L'implémentation consiste, exactement comme pour les fonctions, à: + + 1. Définir la classe + 2. Créer l'URL + 3. Définir le squelette. + +.. code-block:: python + + # wish/views.py + + from django.views.generic import ListView + + from .models import Wishlist + + class WishListList(ListView): + context_object_name = 'wishlists' + model = Wishlist + template_name = 'wish/list.html' + + +.. code-block:: python + + # gwift/urls.py + + from django.conf.urls import include, url + from django.contrib import admin + + from wish.views import WishListList + + urlpatterns = [ + url(r'^admin/', include(admin.site.urls)), + url(r'^$', WishListList.as_view(), name='wishlists'), + ] + +C'est tout. Lancez le serveur, le résultat sera identique. Par inférence, Django construit beaucoup d'informations: si on n'avait pas spécifié les variables ``context_object_name`` et ``template_name``, celles-ci auraient pris les valeurs suivantes: + + * ``context_object_name``: ``wishlist_list`` (ou plus précisément, le nom du modèle suivi de ``_list``) + * ``template_name``: ``wish/wishlist_list.html`` (à nouveau, le fichier généré est préfixé du nom du modèle).