变量(variables)模板中的变量一般使用双括号{}包围。在模板中你可以使用.获取一个变量(字典、对象和列表)的属性。
{{ my_dict.key }}
{{ my_object.attribute }}
{{ my_list.0 }}
标签 (tags)：Django的标签(tags)用{% %}，常用Django标签包括:
# 内容块
{% block content %} 代码块 {% endblock %}
# 防csrf攻击
{% csrf_token %} 表单专用
# for循环
<ul>
{% for athlete in athlete_list %}
<li>{{ forloop.counter }} - {{ athlete.name }}</li>
{% empty %}
<li>Sorry, no athletes。</li>
{% endfor %}
</ul>
# if判断
{% if title == "python" %}
Say python.
{% elif title == "django"}
Say django.
{% elif title == "django"}
Say django.
{% else %}
Say java.
{% endif %}
# url反向解析
{% url 'blog:article_detail' article.id %}
# with
{% with total=business.employees.count %}
{{ total }} employee{{ total|pluralize }}
{% endwith %}
# 载入模板标签过滤器
{% load sometags_library %}
# 模板包含
{% include "header.html" %}
# 模板继承
{% include "base.html" %}
# 获取当前时间now
{% now "jS F Y H:i" %}
过滤器(filters):在模板中你可以使用过滤器(filter)来改变变量在模板中的显示形式。比如{{ article.title | lower }}中lower过滤器可以让文章的标题转化为小写。Django的模板提供了许多内置过滤器，直接使用。
过滤器 | 例子 |
lower, upper | {{ article.title | lower }} 大小写 |
length | {{ name | length }} 长度 |
default | {{ value | default: “0” }} 默认值 |
date | {{ picture.date | date:”Y-m-j “ }} 日期格式 |
dicsort | {{ value | dicsort: “name” }} 字典排序 |
escape | {{ title | escape }} 转义 |
filesizeformat | {{ file | filesizeformat }} 文件大小 |
first, last | {{ list | first }} 首或尾 |
floatformat | {{ value | floatformat }} 浮点格式 |
get_digit | {{ value | get_digit }} 位数 |
join | {{ list | join: “,” }} 字符连接 |
make_list | {{ value | make_list }} 转字符串 |
pluralize | {{ number | pluralize }} 复数 |
random | {{ list | random }} 随机 |
slice | {{ list | slice: “:2” }} 切 |
slugify | {{ title | slugify }} 转为slug |
striptags | {{ body | striptags }} 去除tags |
time | {{ value | time: “H:i” }} 时间格式 |
timesince | {{ pub_date | timesince: given_date }} |
truncatechars | {{ title | truncatechars: 10 }} |
truncatewords | {{ title | truncatewords: 2 }} |
truncatechars_html | {{ title | truncatechars_html: 2 }} |
urlencode | {{ path | urlencode }} URL转义 |
wordcount | {{ body | wordcount }} 单词字数 |
模板文件有两种, 一种是属于整个项目(project)的模板,一种是属于某个应用(app)的模板。模板文件的放置路径必需正确, 否则Django找不到模板容易出现TemplateDoesNotExist的错误。
项目的模板文件路径一般是项目根目录下的templates文件夹。除此以外, 你还需要在settings.py种显示地将模板目录设置为BASE_DIR目录下的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',
],
},
},
]
应用的模板文件路径一般是app目录下的app/templates/app文件夹, 这样做的好处是可以避免模板命名冲突。
在使用render方法指定渲染模板时，无需给出完整的路径，只给出相对于templates的路径即可。
# 指定项目模板
return render(request, "index.html", { "msg": "hello world!",})
# 指定应用模板
return render(request, "blog/list.html", { "articles": articles,})
Django支持模板的继承。你需要使用extends标签。在下面经典模板继承案例中，index.html继承了base.html的布局,如sidebar和footer,但是content模块会替换掉base.html中的content模块。
# base.html
{% block sidebar %}
{% endblock %}
{% block content %}
{% endblock %}
{% block footer %}
{% endblock %}
# index.html
{% extends "base.html" %}
{% block content %}
{{ some code }}
{% endblock }
extends标签支持相对路径，
dir1/
index.html
base2.html
my/
base3.html
base1.htm
{% extends "./base2.html" %}
{% extends "../base1.html" %}
{% extends "./my/base3.html" %}
加载静态文件如css文件和js文件
第一步: 在myproject/settings.py设置静态文件目录STATIC_URL, 默认为static, 其作用是告诉Django静态文件会存放在各app下的static目录里。同时你还需确保django.contrib.staticfiles已经加入到INSTALLED_APPS里去了.
STATIC_URL = '/static/'
第二步: 先在你的app目录下新建一个static文件夹，然后再建一个app子目录，放入你需要的静态文件, 此时静态文件路径变为app/static/app/custom.css或则app/static/app/main.js
如果你需要使用的静态文件不属于某个app，而属于整个项目project，那么你还可以通过STATICFILES_DIRS定义静态文件文件夹列表。假设属于整个项目的静态文件放在根目录下的static文件夹和/var/www/static/里，那么myproject/settings.py加入:
STATICFILES_DIRS = [
BASE_DIR / "static",
'/var/www/static/',
]
第三步：在你的html模板里使用static标签，首先得载入这个标签,
{% load static %}
<!DOCTYPE html>
<html lang="en">
<head>
<title>{% block title %} Django Web Applications {% endblock %} </title>
<link rel="stylesheet" href="{% static 'app/custom.css' %}">
<script type='text/javascript' src="{% static 'app/main.js' %}"></script>
</head>
load static需要放在html的头部位置。如果extends标签和load同时存在，extends需要放在最上面，然后再放load等标签。
