django-keyed-urls 0.4.1

模板标签

使用简单

{% load keyed_urls %}

{% keyed_url 'some_key' as url %}

<a href="{{ url }}">bla</a>

<a href="{% keyed_url 'some_other_key' %}">bla</a>

或

{% load keyed_urls %}

{% keyed_url 'some_key' language='en' as url %}

<a href="{{ url }}">bla</a>

如果键不存在且标签用作赋值标签，则变量设置为 None。否则，将引发一个 KeyDoesNotExist 异常，这也将终止模板渲染。在此方面，其行为与Django自己的 {% url %} 模板标签的行为相同。

辅助工具

另外还有两个辅助工具可用。如果您需要在Python代码中使用URL，请使用以下代码片段

from keyed_urls import get_url

some_url = get_url('some_key')
some_other_url = get_url('some_key', language='en')

与从数据库中获取 KeyedURL 模型并访问其 url 属性相比，使用 get_url 的优点是 get_url 会缓存所有结果。由于 get_url 也被上述模板标签内部使用，这意味着您不必像直接使用模型那样过多地担心性能。如果找不到特定的URL，则 get_url 会引发一个 KeyDoesNotExist 异常。可以通过传递 fail_silently=True 来防止这种情况。

以下代码片段可以用来获取转发URL

from keyed_urls import get_forwarding_url

url = get_forwarding_url('some_key')
url = get_forwarding_url('some_key', language='de')

get_forwarding_url 仅仅是Django自己 reverse 方法的薄层包装。如果键无效，此方法会引发一个 NoReverseMatch 异常，但不会检查数据库中是否存在提供的键。当用户访问链接时，他们会收到一个404响应。为了使 get_forwarding_url 正常工作，您必须将 keyed_urls.urls 包含在您的URLconf中，如上所述，最好放在一个 i18n_patterns 块中。