浅谈Django自定义模板标签template_tags的用处

所属分类: 脚本专栏 / python 阅读数: 1682
收藏 0 赞 0 分享

自定义模板标签,过滤器。英文翻译是Customtemplatetagsandfilters。customfilter自定义过滤器今天不在我的记录范围之内,以后用到再看官方文档也不迟。

**问题1:**customtemplatetags到底长啥样?

customtemplatetags—github

Manytemplatetagstakeanumberofarguments–stringsortemplatevariables–andreturnaresultafterdoingsomeprocessingbasedsolelyontheinputargumentsandsomeexternalinformation.Forexample,acurrent_timetagmightacceptaformatstringandreturnthetimeasastringformattedaccordingly.

Toeasethecreationofthesetypesoftags,Djangoprovidesahelperfunction,simple_tag.Thisfunction,whichisamethodofdjango.template.Library,takesafunctionthatacceptsanynumberofarguments,wrapsitinarenderfunctionandtheothernecessarybitsmentionedaboveandregistersitwiththetemplatesystem.

(为了降低customtags的难度,你可以使用Django提供的快捷函数simple_tag)

Ourcurrent_timefunctioncouldthusbewrittenlikethis:

import datetime
from django import template

register = template.Library()# 只有向系统注册过的tags,系统才认得你。

@register.simple_tag(takes_context=True)#加上这句后我就是一名合格的template tags
def current_time(context, format_string):
  timezone = context['timezone']
  return your_get_current_time_method(timezone, format_string)

Note that the first argument must be called context.
Note that the first argument must be called context.
Note that the first argument must be called context.

@register.simple_tag(takes_context=True)
# 这个装饰器表明这个函数是一个模板标签,takes_context = True 表示接收上下文对象,就是前面所说的封装了各种变量的 Context 对象。
def paginate(context, object_list ,page_count):
  # context是Context 对象,object_list是你要分页的对象,page_count表示每页的数量 , page_count
  left = 3 # 当前页码左边显示几个页码号 -1,比如3就显示2个
  right = 3 # 当前页码右边显示几个页码号 -1
  paginator = Paginator(object_list, page_count) # 通过object_list分页对象

  page = context['request'].GET.get('page') # 从 Http 请求中获取用户请求的页码号
  try:
    object_list = paginator.page(page) # 根据页码号获取第几页的数据
    context['current_page'] = int(page) # 把当前页封装进context(上下文)中
    pages = get_left(context['current_page'], left, paginator.num_pages) + get_right(context['current_page'], right,
                                             paginator.num_pages)
    # 调用了两个辅助函数,根据当前页得到了左右的页码号,比如设置成获取左右两边2个页码号,那么假如当前页是5,则 pages = [3,4,5,6,7],当然一些细节需要处理,比如如果当前页是2,那么获取的是pages = [1,2,3,4]
  except PageNotAnInteger:
    # 异常处理,如果用户传递的page值不是整数,则把第一页的值返回给他
    object_list = paginator.page(1)
    context['current_page'] = 1 # 当前页是1
    pages = get_right(context['current_page'], right, paginator.num_pages)
  except EmptyPage:
    # 如果用户传递的 page 值是一个空值,那么把最后一页的值返回给他
    object_list = paginator.page(paginator.num_pages)
    context['current_page'] = paginator.num_pages # 当前页是最后一页,num_pages的值是总分页数
    pages = get_left(context['current_page'], left, paginator.num_pages)
  context['article_list'] = object_list # 把获取到的分页的数据封装到上下文中
  context['pages'] = pages # 把页码号列表封装进去
  context['last_page'] = paginator.num_pages # 最后一页的页码号
  context['first_page'] = 1 # 第一页的页码号为1
  try:
    # 获取 pages 列表第一个值和最后一个值,主要用于在是否该插入省略号的判断,在模板文件中将会体会到它的用处。注意这里可能产生异常,因为pages可能是一个空列表,比如本身只有一个分页,那么pages就为空,因为我们永远不会获取页码为1的页码号(至少有1页,1的页码号已经固定写在模板文件中)
    context['pages_first'] = pages[0]
    context['pages_last'] = pages[-1] + 1
    # +1的原因是为了方便判断,在模板文件中将会体会到其作用。
  except IndexError:
    context['pages_first'] = 1 # 发生异常说明只有1页
    context['pages_last'] = 2 # 1 + 1 后的值
  return '' # 必须加这个,否则首页会显示个None

问题2:自定义完标签后,在模板中怎么使用呢?

我的自定义过的标签放在templatetags/paginate_tags.py中

处理函数

{% load paginate_tags %}#第一步:把文件名包含进来
{% paginate blogposts 2 %} #第二步:调用函数 添加参数。注意context参数不用你传。

注意:

经由defpaginate(context,object_list,page_count):函数处理过的数据,在模板中如何使用???

  context['article_list'] = object_list # 把获取到的分页的数据封装到上下文中
  context['pages'] = pages # 把页码号列表封装进去
  context['last_page'] = paginator.num_pages # 最后一页的页码号
  context['first_page'] = 1 # 第一页的页码号为1

数据输送到函数中,进行处理,然后将数据封装到之前的context上下文变量中,供template使用,使用方式和使用字典一样。

总结

以上就是本文关于浅谈Django自定义模板标签template_tags的用处的全部内容,希望对大家有所帮助。感兴趣的朋友可以继续参阅本站:

简单了解Django模板的使用

获取Django项目的全部url方法详解

django实现用户登陆功能详解

如有不足之处,欢迎留言指出。感谢朋友们对本站的支持!

更多精彩内容其他人还在看

Python实现按学生年龄排序的实际问题详解

这篇文章主要给大家介绍了关于Python实现按学生年龄排序实际问题的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面跟着小编来一起学习学习吧。
收藏 0 赞 0 分享

Python开发的HTTP库requests详解

Requests是用Python语言编写,基于urllib,采用Apache2 Licensed开源协议的HTTP库。它比urllib更加方便,可以节约我们大量的工作,完全满足HTTP测试需求。Requests的哲学是以PEP 20 的习语为中心开发的,所以它比urllib更加P
收藏 0 赞 0 分享

Python网络爬虫与信息提取(实例讲解)

下面小编就为大家带来一篇Python网络爬虫与信息提取(实例讲解)。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
收藏 0 赞 0 分享

在python3环境下的Django中使用MySQL数据库的实例

下面小编就为大家带来一篇在python3环境下的Django中使用MySQL数据库的实例。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
收藏 0 赞 0 分享

Python 3.x读写csv文件中数字的方法示例

在我们日常开发中经常需要对csv文件进行读写,下面这篇文章主要给大家介绍了关于Python 3.x读写csv文件中数字的相关资料,文中通过示例代码介绍的非常详细,对大家具有一定的参考学习价值,需要的朋友们下面跟着小编来一起学习学习吧。
收藏 0 赞 0 分享

Python实现解析Bit Torrent种子文件内容的方法

这篇文章主要介绍了Python实现解析Bit Torrent种子文件内容的方法,结合实例形式分析了Python针对Torrent文件的读取与解析相关操作技巧与注意事项,需要的朋友可以参考下
收藏 0 赞 0 分享

Python实现文件内容批量追加的方法示例

这篇文章主要介绍了Python实现文件内容批量追加的方法,结合实例形式分析了Python文件的读写相关操作技巧,需要的朋友可以参考下
收藏 0 赞 0 分享

Python简单实现自动删除目录下空文件夹的方法

这篇文章主要介绍了Python简单实现自动删除目录下空文件夹的方法,涉及Python针对文件与目录的读取、判断、删除等相关操作技巧,需要的朋友可以参考下
收藏 0 赞 0 分享

简单学习Python多进程Multiprocessing

这篇文章主要和大家一起简单的学习Python多进程Multiprocessing ,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
收藏 0 赞 0 分享

Python导入模块时遇到的错误分析

这篇文章主要给大家详细解释了在Python处理导入模块的时候出现错误以及具体的情况分析,非常的详尽,有需要的小伙伴可以参考下
收藏 0 赞 0 分享
查看更多