megrok.layout 1.3

布局

布局是一个允许您设计网站的组件。通常，它是所有页面共享的公共结构。技术上，它是一个基于视图组件接口的类，提供了“渲染”和“更新”方法。

让我们实现一个简单的布局

>>> from megrok.layout import Layout
>>> from zope.interface import Interface
>>> import grokcore.component as grok

>>> class MyLayout(Layout):
...     grok.name('mylayout')
...     grok.context(Interface)
...
...     def render(self):
...         return u"a simple layout"

我们使用 grok 我们的组件

>>> grok_component('MyLayout', MyLayout)
True

我们检查它是否已正确注册

>>> from megrok.layout import ILayout
>>> from zope.component import getMultiAdapter
>>> from zope.publisher.browser import TestRequest

>>> layout = getMultiAdapter((TestRequest(), Interface), ILayout)
>>> isinstance(layout, MyLayout)
True
>>> layout.render()
u'a simple layout'

现在让我们看看如何使用页面在特定上下文中使用此布局。

页面

页面是您希望控制的特定代码。它基于 grokcore.View 浏览器页面实现，因此提供了 render 和 update 方法。render 方法将简单地返回由模板或 render 方法代码生成的特定 HTML 代码，而 __call__ 将查找布局组件并在其中渲染。

首先，我们将创建 2 个模型作为示例。

>>> class Aurochs(grok.Context):
...    description = u'Looks like a bull'

>>> class Mammoth(grok.Context):
...    description = u'Looks like an elephant'

现在让我们创建一个页面来显示它们的描述。

>>> from megrok.layout import Page
>>> class AnimalDisplay(Page):
...    grok.name('display')
...    grok.context(Interface)
...
...    def render(self):
...        return self.context.description

通过 grok 我们的页面，我们可以使用它。

>>> grok_component('AnimalDisplay', AnimalDisplay)
True
>>> wooly = Mammoth()
>>> page = getMultiAdapter((wooly, TestRequest()), name='display')
>>> page.content()
u'Looks like an elephant'
>>> page()
u'a simple layout'

正如我们所看到的，页面正在使用布局，在 __call__ 中进行渲染。当然，这个示例布局没有提供任何有趣的功能。让我们通过使用“content”方法来创建一个更有趣的布局，使用我们的页面

>>> class MammothLayout(Layout):
...     grok.context(Mammoth)
...
...     def render(self):
...         return u'Header. Page: %s. Footer' % self.view.content()

>>> grok_component('MammothLayout', MammothLayout)
True
>>> page()
u'Header. Page: Looks like an elephant. Footer'

表单 & 错误页面

表单视图（Form、AddForm、EditForm 和 DisplayForm）和错误视图（NotFoundPage、ExceptionPage、UnauthorizedPage）的基类可用，它们都像页面一样了解布局组件。

变更日志