django-active-link 0.1.6

文档

完整的文档位于https://django-active-link.readthedocs.io。

快速启动

安装django活动链接：

pip install django-active-link

将其添加到已安装的应用程序中

INSTALLED_APPS=(...'active_link',...)

要使用active_linktemplate标记，需要加载active_link_tagstemplatetags库：

{% load active_link_tags %}

要在请求路径与给定视图匹配时向链接添加activecss类，只需执行以下操作。

<ahref="{% url 'view-name' %}"class="{% active_link 'view-name' %}">Menu item</a>

如果您有一个或多个子菜单或选项卡，并且需要它们也处于活动状态和父级，则可以使用||检查此项：

<ahref="{% url 'view-name' %}"class="{% active_link 'view-name || view-sub-name' %}">Menu Item</a><ahref="{% url 'view-sub-name' %}"class="{% active_link 'view-sub-name' %}">Tab Item</a>

您还可以使用自定义css类：

<ahref="{% url 'view-name' %}"class="{% active_link 'view-name' 'custom-class' %}">Menu item</a>

或：

<ahref="{% url 'view-name' %}"class="{% active_link 'view-name' css_class='custom-class' %}">Menu item</a>

默认情况下，active_link不会执行严格匹配。如果只想在严格匹配的情况下添加active类，请将strict参数传递给标记：

<ahref="{% url 'view-name' %}"class="{% active_link strict=True %}">Menu item</a>

用视图的名称（包括命名空间）替换view-name。

设置

可以使用设置ACTIVE_LINK_CSS_CLASS和ACTIVE_LINK_STRICT覆盖默认的活动类和严格模式。

有关更多用法示例，请查看https://django-active-link.readthedocs.io上的完整文档。

important：django活动链接要求当前请求对象在模板上下文中可用。这意味着您在呈现模板时必须使用request context，并且django.core.context\u processors.request必须在template\u context\u processors设置中。有关详细信息，请参见https://docs.djangoproject.com/en/dev/ref/templates/api/#subclassing-context-requestcontext。

待办事项

• 编写文档

运行测试

代码真的有用吗？

source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install tox
(myenv) $ tox

学分

用于呈现此包的工具：

• Cookiecutter
• cookiecutter-djangopackage

历史记录

0.1.0（2017-07-10）

• pypi上的第一个版本。