站长资源脚本专栏

Django模板标签中url使用详解(url跳转到指定页面)

整理:jimmy2026/4/21浏览2
简介django {% url %} 模板标签使用inclusions/_archives.html...{% for date in date_list %}
  • django {% url %} 模板标签使用

    inclusions/_archives.html

    ...
    {% for date in date_list %}
    <li>
    <a href="{% url 'blog:archive' date.year date.month %}" rel="external nofollow" >
    {{ date.year }} 年 {{ date.month }} 月
    </a>
    </li>
    {% endfor %}
    ...

    这里 {% url %} 这个模板标签的作用是解析视图函数 blog:archive 对应的 URL 模式,并把 URL 模式中的年和月替换成 date.year,date.month 的值。

    {% url %} 模板标签接收的第一个参数为被解析视图函数的端点值,这个端点值由 2 部分组成,中间由冒号分隔。第一部分为在应用的 urls.py 中指定的 app_name 的值(充当命名空间,这样即使不同 app 下有相同的视图函数名,也不会冲突),第二部分 path 函数中传入的 name 参数的值。比如在 blog 应用的 urls.py 模块,我们指定了 app_name = 'blog',archive 视图函数的 url 模式为 path('archives/<int:year>/<int:month>/', views.archive, name='archive'),因此对应的端点值为 blog:archive。

    {% url %} 模板标签接收的其它参数为 URL 路径参数,即 URL 模式中路径参数转换器需要捕获的值。例如 archive 视图函数对应的 URL 模式为 archives/<int:year>/<int:month>/,假设 date.year=2017,date.month=5,那么 {% url 'blog:archive' date.year date.month %} 模板标签返回的值为 /archives/2017/5/。

    为什么要使用 {% url %} 模板标签呢?事实上,我们把超链接的 href 属性设置为 /archives/{{ date.year }}/{{ date.month }}/ 同样可以达到目的,但是这种写法是硬编码的。虽然现在 blog:archive 视图函数对应的 URL 模式是这种形式,但是如果哪天这个模式改变了呢?如果使用了硬编码的写法,那你需要把每一处 /archives/{{ date.year }}/{{ date.month }}/ 修改为新的模式。但如果使用了 {% url %} 模板标签,则不用做任何修改。

    示例

    1、主urls.py文件配置如下:

    from django.urls import path
    from django.conf.urls import include
     
    from myblog import views
    urlpatterns = [
     
      path('', views.index), 
      path('myblog/', include('myblog.urls')),
    ]
    

    2、APP的urls.py文件配置如下:

    from django.urls import path
    from myblog import views
     
    urlpatterns = [
     
      path('', views.index), 
     
      path('login/', views.login, name='login'), # 这里设置name,为了在模板文件中,写name,就能找到这个路由
      path('book/', views.book, name='book'),
      path('movie/', views.movie, name='movie'),
      path('book/detail/<book_id>/<catgray>/', views.book_detail, name='detail'),
     
    ]
    

    3、APP的views.py文件如下:

    from distutils.command import register
     
    from django.shortcuts import render, reverse, redirect
    from django.http import HttpResponse
     
     
    def index(request):
      return render(request, 'index.html', {'articles': 18})
     
    def login(request):
      return HttpResponse("注册页面")
     
    def book(request):
      return HttpResponse("读书页面")
     
     
    def movie(request):
      return HttpResponse("电影页面")
     
     
    def book_detail(request, book_id, catgray):
      text = '文章详情页,该文章ID是:%s,分类是:%s' % (book_id, catgray)
      return HttpResponse(text)

    4、index.html文件如下:

    <!DOCTYPE html>
    <html lang="en">
    <head>
      <meta charset="UTF-8">
      <title>Title</title>
    </head>
    <body>
     
     
    <ul>
      <li><a href="/" rel="external nofollow" >首页</a></li>
     
      <li><a href="{% url 'login' %}" rel="external nofollow" >登录</a></li>
      # 点读书就会调到,读书页,路径
      <li><a href="{% url 'book' %}" rel="external nofollow" rel="external nofollow" >读书</a></li>
      # 在这里,直接写name,就能找到urls文件中对应的路由
      <li><a href="{% url 'book' %}" rel="external nofollow" rel="external nofollow" >读书</a></li>
     
      <li><a href="{% url 'movie' %}" rel="external nofollow" >电影</a></li>
     
      <li><a href="{% url 'detail' book_id='1' catgray=2 %}" rel="external nofollow" >最火的一篇文章</a></li>
    </ul>
     
    </body>
    </html>