Django 1.8.2 文档

通用的显示视图

下面两个基于类的通用视图用于显示数据。在许多项目中,它们是最常使用的视图。

详细视图

class django.views.generic.detail.DetailView

执行这个视图的时候,self.object 将包含视图正在操作的对象。

祖先(MRO)

该视图从以下视图继承方法和属性:

方法图谱

  1. dispatch()
  2. http_method_not_allowed()
  3. get_template_names()
  4. get_slug_field()
  5. get_queryset()
  6. get_object()
  7. get_context_object_name()
  8. get_context_data()
  9. get()
  10. render_to_response()

示例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

示例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'),
]

示例myapp/article_detail.html

<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.list.ListView

表示对象列表的一个页面。

执行这个视图的时候,self.object_list 将包含视图正在操作的对象列表(通常是一个查询集,但不是必须的)。

祖先(MRO)

该视图从以下视图继承方法和属性:

方法流程图

  1. dispatch()
  2. http_method_not_allowed()
  3. get_template_names()
  4. get_queryset()
  5. get_context_object_name()
  6. get_context_data()
  7. get()
  8. render_to_response()

示例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

示例myapp/urls.py

from django.conf.urls import url

from article.views import ArticleListView

urlpatterns = [
    url(r'^$', ArticleListView.as_view(), name='article-list'),
]

示例myapp/article_list.html

<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

显示一个对象列表的基础视图。它不是直接使用的,而是作为django.views.generic.list.ListView 的父类或其它表示对象列表的视图的父类。

祖先(MRO)

该视图从以下视图继承方法和属性:

方法

get(request, *args, **kwargs)

添加object_list 到Context 中。如果allow_empty 为True,则显示一个空的列表。如果allow_empty 为False,则引发一个404 错误。