grokcore.layout 4.0

布局

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

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

>>> from grokcore.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_component('MyLayout', MyLayout)
True

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

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

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

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

页面

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

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

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

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

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

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

理解我们的页面将使我们能够使用它。

>>> grok_component('AnimalDisplay', AnimalDisplay)
True
>>> wooly = Mammoth()
>>> page = getMultiAdapter((wooly, TestRequest()), name='display')
>>> print(page.content())
Looks like an elephant
>>> print(page())
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
>>> print(page())
Header. Page: Looks like an elephant. Footer

表单和错误页面

为表单视图（FormPage、AddFormPage、EditFormPage和DisplayFormPage）和错误视图（NotFoundPage、ExceptionPage、UnauthorizedPage）提供了基类，这些类都像页面一样了解布局组件。

变更日志