plone.directives.tiles 1.2

用法

一个基本瓷砖的配置如下

from five import grok
from plone.directives import tiles

from my.package import MyMessageFactory as _
from my.package.interfaces import IMyTileSchema

class MyTile(tiles.Tile):
    grok.context(IContext)
    grok.require('zope2.View')

    grok.name('my.tile')
    grok.title(_(u"My title"))
    grok.description(_(u"My description"))

    tiles.add_permission('mypackage.AddMyTile')
    tiles.schema(IMyTileSchema)

注意事项

• 可以通过从

  PersistentTile派生而不是从

  Tile派生来配置持久性瓷砖。

• context()、requires()、name()和layer()指令的使用方式与从grok.View派生的视图相同。

• 使用与视图相同的语义关联模板。例如，在类

  MyTile中定义的mytiles.py中的瓷砖将默认与模板

  mytiles_templates/mytile.pt关联。

• 与视图不同，name()指令是必需的，并且应按照惯例为瓷砖提供点分名称。

• 定义了字典键访问（__getitem__()）来按照瓷砖的方式工作。在标准grokked视图中，它将从模板中检索宏。在瓷砖中，它用作遍历钩子来设置瓷砖ID，随后用于查找瓷砖上的视图。有关详细信息，请参阅

  plone.tiles。

• 同样，标准grokked视图有一个用于构建URL（可能带有查询字符串参数）的url()方法。对于grokked瓦片，这被一个只读属性url所替换，该属性返回符合plone.tiles规范的瓦片URL。

变更日志