diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/ref/templates/builtins.txt | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt index d3c8355241..2e143a3967 100644 --- a/docs/ref/templates/builtins.txt +++ b/docs/ref/templates/builtins.txt @@ -675,6 +675,29 @@ The template tag will output the string ``/clients/client/123/``. <naming-url-patterns>`, you can refer to the name of the pattern in the ``url`` tag instead of using the path to the view. +Note that if the URL you're reversing doesn't exist, you'll get an +:exc:`NoReverseMatch` exception raised, which will cause your site to display an +error page. + +**New in development verson:** If you'd like to retrieve a URL without displaying it, +you can use a slightly different call: + +.. code-block:: html+django + + {% url path.to.view arg, arg2 as the_url %} + + <a href="{{ the_url }}">I'm linking to {{ the_url }}</a> + +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: + +.. code-block:: html+django + + {% url path.to.view as the_url %} + {% if the_url %} + <a href="{{ the_url }}">Link to optional stuff</a> + {% endif %} + .. templatetag:: widthratio widthratio |