---
title: "Vues génériques d’affichage"
version: 3.1
locale: fr
source: https://docs.djangoproject.com/fr/3.1/ref/class-based-views/generic-display/
canonical: https://djangodocs.dev/fr/3.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/3.1/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectTemplateResponseMixin)
- [`django.views.generic.base.TemplateResponseMixin`](/fr/3.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/3.1/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectMixin)
- [`django.views.generic.base.View`](/fr/3.1/ref/class-based-views/base/#django.views.generic.base.View)

**Index des méthodes**

1. [`setup()`](/fr/3.1/ref/class-based-views/base/#django.views.generic.base.View.setup)
2. [`dispatch()`](/fr/3.1/ref/class-based-views/base/#django.views.generic.base.View.dispatch)
3. [`http_method_not_allowed()`](/fr/3.1/ref/class-based-views/base/#django.views.generic.base.View.http_method_not_allowed)
4. [`get_template_names()`](/fr/3.1/ref/class-based-views/mixins-simple/#django.views.generic.base.TemplateResponseMixin.get_template_names)
5. [`get_slug_field()`](/fr/3.1/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectMixin.get_slug_field)
6. [`get_queryset()`](/fr/3.1/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectMixin.get_queryset)
7. [`get_object()`](/fr/3.1/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectMixin.get_object)
8. [`get_context_object_name()`](/fr/3.1/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectMixin.get_context_object_name)
9. [`get_context_data()`](/fr/3.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/3.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`

A base view for displaying a single object. It is not intended to be used
directly, but rather as a parent class of the
[`django.views.generic.detail.DetailView`](#django.views.generic.detail.DetailView) or other views representing
details of a single object.

**Ancêtres (MRO)**

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

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

**Méthodes**

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

Adds `object` to the context.

## `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/3.1/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectTemplateResponseMixin)
- [`django.views.generic.base.TemplateResponseMixin`](/fr/3.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/3.1/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin)
- [`django.views.generic.base.View`](/fr/3.1/ref/class-based-views/base/#django.views.generic.base.View)

**Index des méthodes**

1. [`setup()`](/fr/3.1/ref/class-based-views/base/#django.views.generic.base.View.setup)
2. [`dispatch()`](/fr/3.1/ref/class-based-views/base/#django.views.generic.base.View.dispatch)
3. [`http_method_not_allowed()`](/fr/3.1/ref/class-based-views/base/#django.views.generic.base.View.http_method_not_allowed)
4. [`get_template_names()`](/fr/3.1/ref/class-based-views/mixins-simple/#django.views.generic.base.TemplateResponseMixin.get_template_names)
5. [`get_queryset()`](/fr/3.1/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin.get_queryset)
6. [`get_context_object_name()`](/fr/3.1/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin.get_context_object_name)
7. [`get_context_data()`](/fr/3.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/3.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 exemple de la documentation de pagination](/fr/3.1/topics/pagination/#using-paginator-in-view). Modifiez les instances de `contacts` de cet exemple en `objet_page`.

#### `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/3.1/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin)
- [`django.views.generic.base.View`](/fr/3.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/3.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/3.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.