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

**Index des méthodes**

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

**Exemple myapp/views.py** :

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

from articles.models import Article

class ArticleDetailView(DetailView):

    model = Article

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

**Exemple myapp/urls.py** :

```
from django.conf.urls import url

from article.views import ArticleDetailView

urlpatterns = [
    url(r'^(?P<slug>[-\w]+)/$', 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>
```

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

**Index des méthodes**

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

**Exemple de fichier views.py**:

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

from articles.models import Article

class ArticleListView(ListView):

    model = Article

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

**Exemple myapp/urls.py** :

```
from django.conf.urls import url

from article.views import ArticleListView

urlpatterns = [
    url(r'^$', 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>
```

#### `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/1.10/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin)
- [`django.views.generic.base.View`](/fr/1.10/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/1.10/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/1.10/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin.allow_empty) vaut `False`, une erreur 404 est générée.