Django 笔记4 -- 模板

Django 笔记4 – 模板

---

Django 系列笔记是笔者学习、实践使用 Django 的相关笔记，大量参考了知了课堂的《Django零基础到项目实战》教程。

参考文档：
Django官方文档（英文）
Django 中文文档

---

一、模板

---

1、模板查找路径配置

配置TEMPLATES：

项目的settings.py文件中，有一个 TEMPLATES 配置，这个配置包含了模板引擎的配置，模板查找路径的配置，模板上下文的配置等。

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(BASE_DIR, 'templates')],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

DIRS： 一个列表，在这个列表中可以存放所有的模板路径，以后在视图中使用 render 或者 render_to_string 渲染模板的时候，会在这个列表的路径中查找模板。

APP_DIRS： 默认为True，这个设置为True后，会在 INSTALLED_APPS 的安装了的APP下的 templates 目录中查找模板。

查找顺序： 查找一个模板，先在 DIRS 这个列表中依次查找路径下有没有这个模板，如果有，就返回。如果DIRS列表中所有的路径都没有找到，那么会先检查当前这个视图所处的 app 是否已经安装，如果已经安装了，那么就先在当前这个 app 下的 templates 文件夹中查找模板，如果没有找到，那么会在其他已经安装了的 app 中查找。如果所有路径下都没有找到，那么会抛出一个 TemplateDoesNotExist 的异常。

2、渲染模板

render_to_string()：

from django.template.loader import render_to_string
from django.http import HttpResponse

# 将模板编译后渲染成Python的字符串格式后，再包装成HttpResponse对象
html = render_to_string("detail.html")
return HttpResponse(html)

render()：

from django.shortcuts import render

# 直接将模板渲染成字符串并包装成HttpResponse对象
return render(request,'list.html')

---

二、DTL 模板

---

1、变量

• Django 在渲染模板的时候，可以传递变量对应的值过去进行替换。变量的命名规范和 Python 非常类似，只能是阿拉伯数字和英文字符以及下划线的组合，不能出现标点符号等特殊字符。变量需要通过视图函数渲染，视图函数在使用 render 或者render_to_string 的时候可以传递一个 context 的参数，这个参数是一个字典类型。以后在模板中的变量就从这个字典中读取值的。
• 模板中使用变量，格式：{{ key }}
• key 是一个字典，通过 key.key 得到 key 这个字典的键对应的值
• key 是一个对象，通过 key.xx 得到 key 这个对象的 xx 属性/方法。
• key 是一个列表/元组，通过 key.1，得到 key 这个列表/元组的第1个值
• 如果 key 中没有指定的东西，返回一个空的字符串

# html 模板代码，profile.html
{{ username }}

# 视图函数代码
def view(request):
    return render(request, 'profile.html',context={'username':'huangyong'})

2、模板标签

if标签： if标签中可以使用==、!=、<、<=、>、>=、in、not in、is、is not等判断运算符。

 {% if  .....  %}
     
 .... 
 {% else %}
     
 .... 
 {% endif %}

for…in…标签： 可以遍历列表、元组、字符串、字典等一切可以遍历的对象

• forloop.counter：当前循环的下标，以1作为起始值。
• forloop.counter0：当前循环的下标，以0作为起始值。
• forloop.first：是否是第一次遍历。
• forloop.last：是否是最后一次遍历。

{% for ... in ... %}
     
{{ ... }}
 {% endfor %}

**for…in…empty标签：**遍历的对象如果没有元素的情况下，会执行empty中的内容

{% for ... in ... %}
     ...
 {% empty %}
     ...
 {% endfor %}

with标签： 复杂的变量缓存到一个变量上

 {% with 变量名=复杂的变量 %}
     
{{ 变量名 }}
 {% endwith %}

url标签： url反转，通常用于 href 属性

 ... 

# url反转，使用关键字参数
图书

3、模版过滤器

通过滤器可以对数据进行处理，类似于函数

add 过滤器： 变量加上一个值

{{ name |add: 'value' }}

date 过滤器： 日期转化成指定格式的字符串

# 数据
context = {"birthday": datetime.now()}

# 转化成 2018-01-01 格式
{{ birthday|date:"Y-m-d" }}

length 过滤器： 获取一个列表/元组/字符串/字典的长度

{{ list|length }}

4、模板继承

父模板：

    
    


    {# 开一个口，子模板中自定义 #}
    {% block main %}{% endblock %}

    {# 也可以写成下面这样，更明了 #}
    {% block main %}{% endblock main %}

子模板：

# 指定继承与那个模板
{% extends "base.html" %}

# 选择父模板中开的口子，自定义内容
{% block main %}自定义内容{% endblock %}

---

三、加载静态文件

---

1、静态文件

在一个网页中，不仅仅只有一个 html 骨架，还需要 css 样式文件，js 执行文件以及图片等。因此在 DTL 中加载静态文件是一个必须要解决的问题。在 DTL 中，使用 static 标签来加载静态文件。要使用 static 标签格式 {% load static %}。

2、静态文件路径配置

1. 首先确保 django.contrib.staticfiles 已经添加到settings.INSTALLED_APPS中。
2. 确保在settings.py中设置了STATIC_URL。
3. 在已经安装了的 app 下创建一个文件夹叫做 static，然后再在这个 static 文件夹下创建一个当前app的名字的文件夹，再把静态文件放到这个文件夹下（如果直接把静态文件放在 static 文件夹下，在多个 app 之间有同名的静态文件时可能就会产生混淆）。
4. 如果有一些静态文件是不和任何app挂钩的。那么可以在 settings.py 中添加 STATICFILES_DIRS，以后 DTL 就会在这个列表的路径中查找静态文件。

    STATICFILES_DIRS = [
        # 项目根目录下的 static 文件夹
        os.path.join(BASE_DIR,"static")
    ]
   

5. 在模版中使用 load 标签加载 static 标签，就可以直接使用 static 文件夹下的静态文件。

    {% load static %}
    
   

6. 如果不想每次在模版中加载静态文件都使用 load 加载 static 标签，那么可以在 settings.py 中的 TEMPLATES.OPTIONS中 添加'builtins':['django.templatetags.static']，这样以后在模版中就可以直接使用 static 标签，而不用手动 load。
7. 如果没有在 settings.INSTALLED_APPS 中添加 django.contrib.staticfiles。那么我们就需要手动的将请求静态文件的 url 与静态文件的路径进行映射了。

   from django.conf import settings
   from django.conf.urls.static import static
   
   urlpatterns = [
       # 其他的url映射
   ] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
   

---

GOOD LUCK!

---