---
title: "Vues génériques d’affichage"
version: 6.1
locale: fr
source: https://docs.djangoproject.com/fr/6.1/ref/class-based-views/generic-display/
canonical: https://djangodocs.dev/fr/6.1/ref/class-based-views/generic-display/
---
# Vues génériques d’affichage

Les deux vues fondées sur des classes suivantes sont conçues pour afficher des données. Pour beaucoup de projets, il s’agit habituellement des vues les plus fréquemment utilisées.

## `DetailView`

#### `class django.views.generic.detail.DetailView`

Dans le code de cette vue, `self.object` contient l’objet sur lequel portent les opérations de la vue.

**Ancêtres (MRO)**

Cette vue hérite des méthodes et des attributs des vues suivantes :

- [`django.views.generic.detail.SingleObjectTemplateResponseMixin`](/fr/6.1/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectTemplateResponseMixin)
- [`django.views.generic.base.TemplateResponseMixin`](/fr/6.1/ref/class-based-views/mixins-simple/#django.views.generic.base.TemplateResponseMixin)
- [`django.views.generic.detail.BaseDetailView`](#django.views.generic.detail.BaseDetailView)
- [`django.views.generic.detail.SingleObjectMixin`](/fr/6.1/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectMixin)
- [`django.views.generic.base.View`](/fr/6.1/ref/class-based-views/base/#django.views.generic.base.View)

**Index des méthodes**

1. [`setup()`](/fr/6.1/ref/class-based-views/base/#django.views.generic.base.View.setup)
2. [`dispatch()`](/fr/6.1/ref/class-based-views/base/#django.views.generic.base.View.dispatch)
3. [`http_method_not_allowed()`](/fr/6.1/ref/class-based-views/base/#django.views.generic.base.View.http_method_not_allowed)
4. [`get_template_names()`](/fr/6.1/ref/class-based-views/mixins-simple/#django.views.generic.base.TemplateResponseMixin.get_template_names)
5. [`get_slug_field()`](/fr/6.1/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectMixin.get_slug_field)
6. [`get_queryset()`](/fr/6.1/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectMixin.get_queryset)
7. [`get_object()`](/fr/6.1/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectMixin.get_object)
8. [`get_context_object_name()`](/fr/6.1/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectMixin.get_context_object_name)
9. [`get_context_data()`](/fr/6.1/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectMixin.get_context_data)
10. [`get()`](#django.views.generic.detail.BaseDetailView.get)
11. [`render_to_response()`](/fr/6.1/ref/class-based-views/mixins-simple/#django.views.generic.base.TemplateResponseMixin.render_to_response)

**Exemple myapp/views.py** :

```
from django.utils import timezone
from django.views.generic.detail import DetailView

from articles.models import Article

class ArticleDetailView(DetailView):
    model = Article

    def get_context_data(self, **kwargs):
        context = super().get_context_data(**kwargs)
        context["now"] = timezone.now()
        return context
```

**Exemple myapp/urls.py** :

```
from django.urls import path

from article.views import ArticleDetailView

urlpatterns = [
    path("<slug:slug>/", ArticleDetailView.as_view(), name="article-detail"),
]
```

**Exemple myapp/article\_detail.html** :

```html+django
<h1>{{ object.headline }}</h1>
<p>{{ object.content }}</p>
<p>Reporter: {{ object.reporter }}</p>
<p>Published: {{ object.pub_date|date }}</p>
<p>Date: {{ now|date }}</p>
```

#### `class django.views.generic.detail.BaseDetailView`

Une vue de base pour l’affichage d’un seul objet. Elle n’est pas conçue pour être utilisée directement, mais plutôt comme classe parente pour `django.views.generic.list.Detailiew` ou d’autres vues représentant les détails d’un seul objet.

**Ancêtres (MRO)**

Cette vue hérite des méthodes et des attributs des vues suivantes :

- [`django.views.generic.detail.SingleObjectMixin`](/fr/6.1/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectMixin)
- [`django.views.generic.base.View`](/fr/6.1/ref/class-based-views/base/#django.views.generic.base.View)

**Méthodes**

#### `get(request, *args, **kwargs)`

Ajoute `object` au contexte.

## `ListView`

#### `class django.views.generic.list.ListView`

Une page représentant une liste d’objets.

Dans le code de cette vue, `self.object_list` contient la liste d’objets (normalement un jeu de requête, mais pas toujours) sur laquelle portent les opérations de la vue.

**Ancêtres (MRO)**

Cette vue hérite des méthodes et des attributs des vues suivantes :

- [`django.views.generic.list.MultipleObjectTemplateResponseMixin`](/fr/6.1/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectTemplateResponseMixin)
- [`django.views.generic.base.TemplateResponseMixin`](/fr/6.1/ref/class-based-views/mixins-simple/#django.views.generic.base.TemplateResponseMixin)
- [`django.views.generic.list.BaseListView`](#django.views.generic.list.BaseListView)
- [`django.views.generic.list.MultipleObjectMixin`](/fr/6.1/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin)
- [`django.views.generic.base.View`](/fr/6.1/ref/class-based-views/base/#django.views.generic.base.View)

**Index des méthodes**

1. [`setup()`](/fr/6.1/ref/class-based-views/base/#django.views.generic.base.View.setup)
2. [`dispatch()`](/fr/6.1/ref/class-based-views/base/#django.views.generic.base.View.dispatch)
3. [`http_method_not_allowed()`](/fr/6.1/ref/class-based-views/base/#django.views.generic.base.View.http_method_not_allowed)
4. [`get_template_names()`](/fr/6.1/ref/class-based-views/mixins-simple/#django.views.generic.base.TemplateResponseMixin.get_template_names)
5. [`get_queryset()`](/fr/6.1/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin.get_queryset)
6. [`get_context_object_name()`](/fr/6.1/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin.get_context_object_name)
7. [`get_context_data()`](/fr/6.1/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin.get_context_data)
8. [`get()`](#django.views.generic.list.BaseListView.get)
9. [`render_to_response()`](/fr/6.1/ref/class-based-views/mixins-simple/#django.views.generic.base.TemplateResponseMixin.render_to_response)

**Exemple de fichier views.py**:

```
from django.utils import timezone
from django.views.generic.list import ListView

from articles.models import Article

class ArticleListView(ListView):
    model = Article
    paginate_by = 100  # if pagination is desired

    def get_context_data(self, **kwargs):
        context = super().get_context_data(**kwargs)
        context["now"] = timezone.now()
        return context
```

**Exemple myapp/urls.py** :

```
from django.urls import path

from article.views import ArticleListView

urlpatterns = [
    path("", ArticleListView.as_view(), name="article-list"),
]
```

**Exemple myapp/article\_list.html** :

```html+django
<h1>Articles</h1>
<ul>
{% for article in object_list %}
    <li>{{ article.pub_date|date }} - {{ article.headline }}</li>
{% empty %}
    <li>No articles yet.</li>
{% endfor %}
</ul>
```

Si vous utilisez la pagination, vous pouvez adapter le [gabarit d’exemple de la documentation sur la pagination](/fr/6.1/topics/pagination/#paginating-a-list-view).

#### `class django.views.generic.list.BaseListView`

Une vue de base pour l’affichage d’une liste d’objets. Elle n’est pas conçue pour être utilisée directement, mais plutôt comme classe parente pour  [`django.views.generic.list.ListView`](#django.views.generic.list.ListView) ou d’autres vues représentant des listes d’objets.

**Ancêtres (MRO)**

Cette vue hérite des méthodes et des attributs des vues suivantes :

- [`django.views.generic.list.MultipleObjectMixin`](/fr/6.1/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin)
- [`django.views.generic.base.View`](/fr/6.1/ref/class-based-views/base/#django.views.generic.base.View)

**Méthodes**

#### `get(request, *args, **kwargs)`

Ajoute `object_list` au contexte. Si [`allow_empty`](/fr/6.1/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin.allow_empty) vaut `True`, une liste vide est affichée. Si [`allow_empty`](/fr/6.1/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin.allow_empty) vaut `False`, une erreur 404 est générée.