# 使用django-tables2展示HTML表
作为不擅长前端的Django初学者，如何能够美观展示HTML table是一个头疼的事。
虽然django很容易实现查询表格并展示，但是简陋的table显得很不专业。
django-tables2 是一个创建HTML tables的app，简化了对样式等技术的开发要求。
> 本文是官方手册的摘要，原文非常简练，以快速完成项目工作为目标。
* 安装`django-tables2`
```
pip install django-tables2
```
## 在app中使用`django-tables2`
* 创建Django app (这里命名是`tutorial`)
```
python manage.py startapp tutorial
```
* 在项目的`settings.py`的`INSTALLED_APPS`中添加`django_tables2`和`turorial`
* 在`tutorial/models.py`中添加model
```python
# tutorial/models.py
class Person(models.Model):
name = models.CharField(max_length=100, verbose_name='full name')
```
* 使用以下命令创建数据库表
```
python manage.py makemigrations tutorial
python manage.py migrate tutorial
```
* 通过django shell添加数据库表内容
```
$ python manage.py shell
>>> from tutorial.models import Person
>>> Person.objects.bulk_create([Person(name='Jieter'), Person(name='Bradley')])
[, ]
```
* 处理`Person`查询集的视图
```python
# tutorial/views.py
from django.shortcuts import render
from .models import Person
def people(request):
return render(request, 'tutorial/people.html', {'people': Person.objects.all()})
```
* 创建模板
```markup
{# tutorial/templates/tutorial/people.html #}
{% load render_table from django_tables2 %}
List of persons
{% render_table people %}
```
> 以上完成后可以看到一个简单的页面
下面将开始真正的Table定制
* 为了能够定义一个定制的查询页面，首先定义一个`Table`类：
```python
# tutorial/tables.py
import django_tables2 as tables
from .models import Person
class PersonTable(tables.Table):
class Meta:
model = Person
template = 'django_tables2/bootstrap.html'
```
* 然后配置view中的table
```python
# tutorial/views.py
from django.shortcuts import render
from django_tables2 import RequestConfig
from .models import Person
from .tables import PersonTable
def people(request):
table = PersonTable(Person.objects.all())
RequestConfig(request).configure(table)
return render(request, 'people.html', {'table': table})
```
> 使用`RequestConfig`自动从`reuqest.GET`取出值并相应过更新表格。这样数据就会整齐和页面化。
* 然后将查询集(`queryset`)传递给`render_table`而不是传递给table instance：
```markup
{# tutorial/templates/tutorial/people.html #}
{% load render_table from django_tables2 %}
List of persons
{% render_table table %}
```
现在就可以看到一个bootstrap3 stylesheet的表单了：
## 参考
* [django-tables2 Doc：Tutorial](http://django-tables2.readthedocs.io/en/latest/pages/tutorial.html)
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://huataihuang.gitbook.io/cloud-atlas-draft/develop/python/django/startup/use_django-table2.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.