- en
- Langue : fr
Vues génériques basées sur les dates¶
Les vues génériques basées sur les dates, définies dans django.views.generic.dates, sont des vues destinées à afficher des pages énumérant en détails des données en fonction de leur date.
Note
Quelques exemples de cette page se basent sur le modèle Article défini comme suit dans myapp/models.py:
from django.db import models
from django.core.urlresolvers import reverse
class Article(models.Model):
title = models.CharField(max_length=200)
pub_date = models.DateField()
def get_absolute_url(self):
return reverse('article-detail', kwargs={'pk': self.pk})
ArchiveIndexView¶
- class ArchiveIndexView[source]¶
Une page de sommaire de premier niveau affichant les « derniers » objets par date. Les objets ayant une date dans le futur ne sont pas inclus, sauf si allow_future est défini à True.
Ancêtres (MRO)
- django.views.generic.list.MultipleObjectTemplateResponseMixin
- django.views.generic.base.TemplateResponseMixin
- django.views.generic.dates.BaseArchiveIndexView
- django.views.generic.dates.BaseDateListView
- django.views.generic.list.MultipleObjectMixin
- django.views.generic.dates.DateMixin
- django.views.generic.base.View
Contexte
En plus du contexte fourni par django.views.generic.list.MultipleObjectMixin (via django.views.generic.dates.BaseDateListView), le contexte de gabarit sera :
date_list: un objet QuerySet contenant toutes les années possédant des objets disponibles en fonction de queryset, représentés sous forme d’objets datetime.datetime dans l’ordre chronologique inverse.
Notes
La valeur par défaut de context_object_name est latest.
La valeur par défaut de template_name_suffix est _archive.
Le comportement par défaut est de fournir date_list par année, mais il est possible aussi d’utiliser des mois ou des jours en modifiant l’attribut date_list_period. Cela s’applique également à toutes les sous-classes de cette vue.
Exemple myapp/urls.py :
from django.conf.urls import url from django.views.generic.dates import ArchiveIndexView from myapp.models import Article urlpatterns = [ url(r'^archive/$', ArchiveIndexView.as_view(model=Article, date_field="pub_date"), name="article_archive"), ]
Exemple de myapp/article_archive.html:
<ul> {% for article in latest %} <li>{{ article.pub_date }}: {{ article.title }}</li> {% endfor %} </ul>
Ceci affiche tous les articles.
YearArchiveView¶
- class YearArchiveView[source]¶
Une page d’archives annuelles affichant tous les mois disponibles d’une année donnée. Les objets ayant une date dans le futur ne sont pas inclus, sauf si allow_future est défini à True.
Ancêtres (MRO)
- django.views.generic.list.MultipleObjectTemplateResponseMixin
- django.views.generic.base.TemplateResponseMixin
- django.views.generic.dates.BaseYearArchiveView
- django.views.generic.dates.YearMixin
- django.views.generic.dates.BaseDateListView
- django.views.generic.list.MultipleObjectMixin
- django.views.generic.dates.DateMixin
- django.views.generic.base.View
- make_object_list¶
Un booléen indiquant s’il faut récupérer la liste complète des objets de l’année courante et les passer au gabarit. Si la valeur est à True, la liste sera disponible dans le contexte. Sinon, si la valeur est à False, le jeu de requête None sera utilisé en tant que liste d’objets. Par défaut, cette valeur vaut False.
- get_make_object_list()¶
Détermine si une liste d’objets est renvoyée comme une portion du contexte. Renvoie make_object_list par défaut.
Contexte
En plus du contexte fourni par django.views.generic.list.MultipleObjectMixin (via django.views.generic.dates.BaseDateListView), le contexte de gabarit sera :
date_list: un objet QuerySet contenant tous les mois possédant des objets disponibles en fonction de queryset, représentés sous forme d’objets datetime.datetime dans l’ordre chronologique.
year: un objet date représentant l’année indiquée.
next_year: un objet date représentant le premier jour de l’année suivante, en fonction de allow_empty et allow_future.
previous_year: un objet date représentant le premier jour de l’année précédente, en fonction de allow_empty et allow_future.
Notes
La valeur par défaut de template_name_suffix est _archive_year.
Exemple myapp/views.py :
from django.views.generic.dates import YearArchiveView from myapp.models import Article class ArticleYearArchiveView(YearArchiveView): queryset = Article.objects.all() date_field = "pub_date" make_object_list = True allow_future = True
Exemple myapp/urls.py :
from django.conf.urls import url from myapp.views import ArticleYearArchiveView urlpatterns = [ url(r'^(?P<year>[0-9]{4})/$', ArticleYearArchiveView.as_view(), name="article_year_archive"), ]
Exemple myapp/article_archive_year.html :
<ul> {% for date in date_list %} <li>{{ date|date }}</li> {% endfor %} </ul> <div> <h1>All Articles for {{ year|date:"Y" }}</h1> {% for obj in object_list %} <p> {{ obj.title }} - {{ obj.pub_date|date:"F j, Y" }} </p> {% endfor %} </div>
MonthArchiveView¶
- class MonthArchiveView[source]¶
Une page d’archives mensuelles affichant tous les objets disponibles d’un mois donné. Les objets ayant une date dans le futur ne sont pas inclus, sauf si allow_future est défini à True.
Ancêtres (MRO)
- django.views.generic.list.MultipleObjectTemplateResponseMixin
- django.views.generic.base.TemplateResponseMixin
- django.views.generic.dates.BaseMonthArchiveView
- django.views.generic.dates.YearMixin
- django.views.generic.dates.MonthMixin
- django.views.generic.dates.BaseDateListView
- django.views.generic.list.MultipleObjectMixin
- django.views.generic.dates.DateMixin
- django.views.generic.base.View
Contexte
En plus du contexte fourni par la classe MultipleObjectMixin (via BaseDateListView), le contexte du gabarit sera :
date_list: un objet QuerySet contenant tous les jours possédant des objets disponibles dans le mois indiqué, en fonction de queryset, représentés sous forme d’objets datetime.datetime dans l’ordre chronologique.
month: un objet date représentant le mois donné.
next_month: un objet date représentant le premier jour du mois suivant, en fonction de allow_empty et allow_future.
previous_month: un objet date représentant le premier jour du mois précédent, en fonction de allow_empty et allow_future.
Notes
La valeur par défaut de template_name_suffix est _archive_month.
Exemple myapp/views.py :
from django.views.generic.dates import MonthArchiveView from myapp.models import Article class ArticleMonthArchiveView(MonthArchiveView): queryset = Article.objects.all() date_field = "pub_date" allow_future = True
Exemple myapp/urls.py :
from django.conf.urls import url from myapp.views import ArticleMonthArchiveView urlpatterns = [ # Example: /2012/aug/ url(r'^(?P<year>[0-9]{4})/(?P<month>[-\w]+)/$', ArticleMonthArchiveView.as_view(), name="archive_month"), # Example: /2012/08/ url(r'^(?P<year>[0-9]{4})/(?P<month>[0-9]+)/$', ArticleMonthArchiveView.as_view(month_format='%m'), name="archive_month_numeric"), ]
Exemple myapp/article_archive_month.html :
<ul> {% for article in object_list %} <li>{{ article.pub_date|date:"F j, Y" }}: {{ article.title }}</li> {% endfor %} </ul> <p> {% if previous_month %} Previous Month: {{ previous_month|date:"F Y" }} {% endif %} {% if next_month %} Next Month: {{ next_month|date:"F Y" }} {% endif %} </p>
WeekArchiveView¶
- class WeekArchiveView[source]¶
Une page d’archives hebdomadaires affichant tous les objets disponibles d’une semaine donnée. Les objets ayant une date dans le futur ne sont pas inclus, sauf si allow_future est défini à True.
Ancêtres (MRO)
- django.views.generic.list.MultipleObjectTemplateResponseMixin
- django.views.generic.base.TemplateResponseMixin
- django.views.generic.dates.BaseWeekArchiveView
- django.views.generic.dates.YearMixin
- django.views.generic.dates.WeekMixin
- django.views.generic.dates.BaseDateListView
- django.views.generic.list.MultipleObjectMixin
- django.views.generic.dates.DateMixin
- django.views.generic.base.View
Contexte
En plus du contexte fourni par la classe MultipleObjectMixin (via BaseDateListView), le contexte du gabarit sera :
week: un objet date représentant le premier jour de la semaine indiquée.
next_week: un objet date représentant le premier jour de la semaine suivante, en fonction de allow_empty et allow_future.
previous_week: un objet date représentant le premier jour de la semaine précédente, en fonction de allow_empty et allow_future.
Notes
La valeur par défaut de template_name_suffix est _archive_week.
Exemple myapp/views.py :
from django.views.generic.dates import WeekArchiveView from myapp.models import Article class ArticleWeekArchiveView(WeekArchiveView): queryset = Article.objects.all() date_field = "pub_date" week_format = "%W" allow_future = True
Exemple myapp/urls.py :
from django.conf.urls import url from myapp.views import ArticleWeekArchiveView urlpatterns = [ # Example: /2012/week/23/ url(r'^(?P<year>[0-9]{4})/week/(?P<week>[0-9]+)/$', ArticleWeekArchiveView.as_view(), name="archive_week"), ]
Exemple myapp/article_archive_week.html :
<h1>Week {{ week|date:'W' }}</h1> <ul> {% for article in object_list %} <li>{{ article.pub_date|date:"F j, Y" }}: {{ article.title }}</li> {% endfor %} </ul> <p> {% if previous_week %} Previous Week: {{ previous_week|date:"F Y" }} {% endif %} {% if previous_week and next_week %}--{% endif %} {% if next_week %} Next week: {{ next_week|date:"F Y" }} {% endif %} </p>
Dans cet exemple, nous affichons le numéro de la semaine. Par défaut, week_format dans la classe WeekArchiveView utilise le format de semaine '%U' qui se base sur le calendrier américain, où les semaines commencent le dimanche. Le format '%W' utilise quant à lui le format ISO, où les semaines commencent le lundi. Le format '%W' est le même que dans strftime() et date.
Cependant, le filtre de gabarit date n’a pas de format d’affichage équivalent pour prendre en charge le calendrier américain. En effet, le format '%U' du filtre date affiche le nombre de secondes écoulées depuis le début de l’époque Unix.
DayArchiveView¶
- class DayArchiveView[source]¶
Une page d’archives journalières affichant tous les objets disponibles d’un jour donné. Les jours ayant une date dans le futur génèrent une erreur 404, sans considérer si des objets existent pour les jours futurs, sauf si allow_future est défini à True.
Ancêtres (MRO)
- django.views.generic.list.MultipleObjectTemplateResponseMixin
- django.views.generic.base.TemplateResponseMixin
- django.views.generic.dates.BaseDayArchiveView
- django.views.generic.dates.YearMixin
- django.views.generic.dates.MonthMixin
- django.views.generic.dates.DayMixin
- django.views.generic.dates.BaseDateListView
- django.views.generic.list.MultipleObjectMixin
- django.views.generic.dates.DateMixin
- django.views.generic.base.View
Contexte
En plus du contexte fourni par la classe MultipleObjectMixin (via BaseDateListView), le contexte du gabarit sera :
day: un objet date représentant le jour indiqué.
next_day: un objet date représentant le jour suivant, en fonction de allow_empty et allow_future.
previous_day: un objet date représentant le jour précédent, en fonction de allow_empty et allow_future.
next_month: un objet date représentant le premier jour du mois suivant, en fonction de allow_empty et allow_future.
previous_month: un objet date représentant le premier jour du mois précédent, en fonction de allow_empty et allow_future.
Notes
La valeur par défaut de template_name_suffix est _archive_day.
Exemple myapp/views.py :
from django.views.generic.dates import DayArchiveView from myapp.models import Article class ArticleDayArchiveView(DayArchiveView): queryset = Article.objects.all() date_field = "pub_date" allow_future = True
Exemple myapp/urls.py :
from django.conf.urls import url from myapp.views import ArticleDayArchiveView urlpatterns = [ # Example: /2012/nov/10/ url(r'^(?P<year>[0-9]{4})/(?P<month>[-\w]+)/(?P<day>[0-9]+)/$', ArticleDayArchiveView.as_view(), name="archive_day"), ]
Exemple myapp/article_archive_day.html :
<h1>{{ day }}</h1> <ul> {% for article in object_list %} <li>{{ article.pub_date|date:"F j, Y" }}: {{ article.title }}</li> {% endfor %} </ul> <p> {% if previous_day %} Previous Day: {{ previous_day }} {% endif %} {% if previous_day and next_day %}--{% endif %} {% if next_day %} Next Day: {{ next_day }} {% endif %} </p>
TodayArchiveView¶
- class TodayArchiveView[source]¶
Une page d’archives journalières affichant tous les objets disponibles pour aujourd’hui. C’est exactement la même vue que django.views.generic.dates.DayArchiveView, excepté que c’est la date du jour qui est prise en compte à la place des paramètres year/month/day.
Ancêtres (MRO)
- django.views.generic.list.MultipleObjectTemplateResponseMixin
- django.views.generic.base.TemplateResponseMixin
- django.views.generic.dates.BaseTodayArchiveView
- django.views.generic.dates.BaseDayArchiveView
- django.views.generic.dates.YearMixin
- django.views.generic.dates.MonthMixin
- django.views.generic.dates.DayMixin
- django.views.generic.dates.BaseDateListView
- django.views.generic.list.MultipleObjectMixin
- django.views.generic.dates.DateMixin
- django.views.generic.base.View
Notes
La valeur par défaut de template_name_suffix est _archive_today.
Exemple myapp/views.py :
from django.views.generic.dates import TodayArchiveView from myapp.models import Article class ArticleTodayArchiveView(TodayArchiveView): queryset = Article.objects.all() date_field = "pub_date" allow_future = True
Exemple myapp/urls.py :
from django.conf.urls import url from myapp.views import ArticleTodayArchiveView urlpatterns = [ url(r'^today/$', ArticleTodayArchiveView.as_view(), name="archive_today"), ]
Où se trouve le gabarit d’exemple pour TodayArchiveView?
Cette vue utilise par défaut le même gabarit que DayArchiveView, qui figure dans l’exemple précédent. Si vous avez besoin d’un gabarit différent, définissez l’attribut template_name avec le nom du nouveau gabarit.
DateDetailView¶
- class DateDetailView[source]¶
Une page représentant un objet individuel. Si l’objet contient une valeur de date dans le futur, la vue génère par défaut une erreur 404, sauf si allow_future est défini à True.
Ancêtres (MRO)
- django.views.generic.detail.SingleObjectTemplateResponseMixin
- django.views.generic.base.TemplateResponseMixin
- django.views.generic.dates.BaseDateDetailView
- django.views.generic.dates.YearMixin
- django.views.generic.dates.MonthMixin
- django.views.generic.dates.DayMixin
- django.views.generic.dates.DateMixin
- django.views.generic.detail.BaseDetailView
- django.views.generic.detail.SingleObjectMixin
- django.views.generic.base.View
Contexte
Inclut l’objet unique associé au model défini dans la vue DateDetailView.
Notes
La valeur par défaut de template_name_suffix est _detail.
Exemple myapp/urls.py :
from django.conf.urls import url from django.views.generic.dates import DateDetailView urlpatterns = [ url(r'^(?P<year>[0-9]{4})/(?P<month>[-\w]+)/(?P<day>[0-9]+)/(?P<pk>[0-9]+)/$', DateDetailView.as_view(model=Article, date_field="pub_date"), name="archive_date_detail"), ]
Exemple myapp/article_detail.html :
<h1>{{ object.title }}</h1>
Note
Toutes les vues génériques mentionnées ci-dessus ont des vues Base correspondantes dont la seule différence est de ne pas inclure MultipleObjectTemplateResponseMixin (pour les vues d’archives) ni SingleObjectTemplateResponseMixin (pour DateDetailView) :