rebecca.menu 0.1

安装

您可以使用pip安装 rebecca.menu。

$ pip install rebecca.menu

注册并使用菜单

要添加菜单，请使用 add_route_menu 指令。

config.add_route('menu1', '/menus/menu1')
config.add_route('menu2', '/menus/menu2')
config.add_route_menu(menu_name="system", route_name="menu1", display_name="system menu item1")

或者使用 route_menu_config 装饰器。

@route_menu_config('system')
class SystemMenu3(object):
    route_name="menu3"
    display_name = "system menu item3"

要获取菜单，请使用 get_menu API

from rebecca.menu import get_menu

def menu(request):
    system_menu = get_menu(request, system)
    return dict(menu=system_menu)

get_menu 返回一个提供 rebecca.menu.interfaces.IMenu 的对象。 IMenu 有一个名为 menu_items 的属性，它是一个包含 IMenuItem 的列表。

IMenuItem 有一些属性，如 display_name、name 和 url。您可能需要在模板中使用菜单项，如下所示

<ul class="nav">
%for m in system_menu.menu_items:
    <li><a href="${m.url}">${m.display_name}</a></li>
%endfor
</ul>

权限

带有权限的菜单注册

@route_menu_config('system')
class SystemMenu3(object):
    route_name="menu3"
    display_name = "system menu item3"
    permission = 'menu3-permission'

get_menu 使用 has_permission 检查请求的权限，导致 menu_items 包含通过权限检查的菜单项。

Matchdict

如果路由有占位符，菜单URL将填充来自 request.matchdict 的值。

config.add_route("menu1", 'menus/menu1/{testing_vars}')
menu_factory.add_item(route_name="menu1", display_name="testing-menu1")

当 matchdict 中有 testing_vars 的值为“that-is-testing”时，menu1的URL是“menus/menu1/that-is-testing”。