p31829507
/
django
mirror of https://github.com/django/django.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

[1.6.x] Fixed #13116 -- Described scope of variables created by {% url ... as var %} syntax. 

Thanks leif_p for the suggestion.

Backport of 4a5aac47a6 from master
This commit is contained in:
Tim Graham 2014-01-17 14:50:47 -05:00
parent b8ec3b6ddd
commit 4f058655d0
1 changed files with 3 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
docs/ref/templates/builtins.txt
View File

@ -1047,11 +1047,13 @@ cause your site to display an error page.
If you'd like to retrieve a URL without displaying it, you can use a slightly If you'd like to retrieve a URL without displaying it, you can use a slightly
different call:: different call::
{% url 'path.to.view' arg arg2 as the_url %} {% url 'path.to.view' arg arg2 as the_url %}
<a href="{{ the_url }}">I'm linking to {{ the_url }}</a> <a href="{{ the_url }}">I'm linking to {{ the_url }}</a>
The scope of the variable created by the ``as var`` syntax is the
``{% block %}`` in which the ``{% url %}`` tag appears.
This ``{% url ... as var %}`` syntax will *not* cause an error if the view is This ``{% url ... as var %}`` syntax will *not* cause an error if the view is
missing. In practice you'll use this to link to views that are optional:: missing. In practice you'll use this to link to views that are optional::