Django模板基础:变量、逻辑标签与内置Filter详解

一只小鹿
一只小鹿
发布时间:2026-10-13 | 4人浏览过
原创

本文详细解析Django框架中模板语言的核心用法,涵盖变量渲染、Context与Template模块基础、views.py与HTML交互,以及for/if等逻辑语法。重点介绍内置Filter如default、slice、date等的使用方法,并指导如何创建templatetags模块实现自定义Filter,帮助开发者高效构建动态Web页面。

Django模板基础概述

本文详细介绍Django框架中基础模板标签与Filter函数的具体应用方法,旨在为读者提供清晰的实践参考。

基础模板语言与变量渲染

一、掌握基础模板语言

1、变量处理机制

{{ }}

1.1、启动Django Shell交互环境


python manage.py shell

1.2、Context与Template模块的基础操作


from django.template import Context,Template
t = Template('My name id {{ name }}')
c = Context({'name':'Stephane'})
t.render(c)

1.3、views.py视图文件配置


def index(request):
  list = ['小明','小花','小包']
  dict = {'age':14,'user':'小高'}
  return render(request,'index.html',{'list':list,'dict':dict})

1.4、index.html模板文件编写


<div>
  <!-- 获得列表第一个名字:“小明” -->
  {{ list.0 }}
  <!-- 获得字典中的 age 项 -->
  {{ dict.age }}
  <!-- 过滤 flite 的使用 -->
  {{ dict.age | 过滤条件 }}
</div>

模板逻辑语法与标签使用

2、逻辑控制语法

{%  %}

2.1、循环结构与条件判断

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

{% endfor %}

{% if %}

{% else %}

{% endif %}

{% url '网页路径' %} 用于指定路由路径

<form>

{% csrf_token %} 用于生成CSRF令牌以验证跨域请求

</form>

{% load 标签库 %} 用于加载自定义或第三方标签库

3、模板内的逻辑运算规则:

3.1、支持 ==, !=, >=, <=, >, < 等比较运算符(注意:运算符两侧必须保留至少一个空格)。


{% if var >= 90 %}
成绩优秀,学得不错
{% elif var >= 80 %}
成绩良好
{% elif var >= 70 %}
成绩一般
{% elif var >= 60 %}
需要努力
{% else %}
不及格啊,大哥!
{% endif %}

3.2、支持 and, or, not, in, not in , is , is not 等逻辑运算符。


{% if num <= 100 and num >= 0 %}
num在0到100之间
{% else %}
数值不在范围之内!
{% endif %}

4、注释语法


{# value #}

内置Filter过滤器详解

二、Django模板内置方法解析

1、Filters 内置过滤器语法

基本格式:{{ value|filter_name:参数 }}。其中 value 代表变量名,filter_name 指代Django内置或自定义的Filter函数,参数为处理所需的值。

3.1、{{ value|default:参数 }}:当value未传值或为空时,使用default设置的参数进行替换。

3.2、{{ value|default_if_none:参数 }}:当value显式为None时,使用default设置的参数进行替换。

3.2、{{ value|length }}:返回value的长度值。

3.3、{{ value|filesizeformat }}:将数值格式化为易读的文件大小(如1.5k,5M等)。

3.4、{{ value|slice:" 2:1" }}:对value执行切片操作(支持负数索引)。

3.5、{{ value|date:"Y:m:d H:i:s"}}:按指定格式输出时间。

3.6、{{ value|safe }}:标记内容为安全HTML,直接解析为可执行的HTML代码。

3.7、{{ value|truncatechars:30 }}:截取value,仅显示前30个字符,超出部分以“...”代替。

3.8、{{ value|add:10 }}:执行加法运算。

3.9、{{ value|capfirst }}:将字符串首字母转换为大写。

3.9、{{ value|cut:'a' }}:从字符串中移除指定的字符'a'。

自定义Filter开发与调用

2、自定义Filter的实现

2.1、在APP项目目录下新建 templatetags 模块,并在.py文件中编写自定义逻辑。


# 自定义filter的基本语法
form Django import template # 引用Django中的模块
register = template.Library() # 实例化一个模板对象
# 将自定义的 filter 注册到程序中
@register.filter
'''
  @register.filter(name = 'fleter_name') 这个装饰器把自定义的filter注册到程序中,
  让其可以使用自定义的 filter 方法; reg是 ‘|' 前面的变量 reg2是方法后面的参数。
'''
@register.filter(name = 'add')
def add(reg):
  return '{}'.format(reg)
@register.filter(name = 'add_str')
def add_str(reg,reg2):
  return '{} {}'.format(reg,reg2)

2.2、在HTML文件中调用自定义Filter的方法


<!-- 导入自定义的filter方法 -->
{% load filter %}
{{ value|add }}
{{ value|add_str:'123'}}
{% if num|fliter:参数 %}
  内容
{% endif %}

若修改自定义Filter代码,需手动重启Python服务方可生效。

希望本文所述内容能帮助读者更好地掌握基于Django框架的Python程序设计技巧。

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表