plone.autoform 2.0.2

改变字段的展示模式

字段的部件可以以几种“模式”显示

• input - 允许用户在字段中输入数据

• display - 字段值的只读指示

• hidden - 仅在 HTML 源中包含的字段值的记录

可以使用 mode 指令来控制模式

from plone.supermodel import model
from plone.autoform import directives as form

class IMySchema(model.Schema):

    form.mode(secret='hidden')
    form.mode(IEditForm, secret='input')
    secret = schema.TextLine(
        title=u"Secret",
        default=u"Secret stuff (except on edit forms)"
        )

在这种情况下，对于 secret 字段，将模式设置为‘hidden’以用于大多数表单，但对于提供 IEditForm 接口的表单设置为‘input’

相应的超级模型 XML 指令是 form:mode

<field type="zope.schema.TextLine"
        name="secret"
        form:mode="z3c.form.interfaces.IForm:hidden z3c.form.interfaces.IEditForm:input">
    <title>Secret</title>
    <description>Secret stuff (except on edit forms)</description>
</field>

如果对于所有表单应使用相同的模式，可以简要指定模式

<field type="zope.schema.TextLine"
        name="secret"
        form:mode="hidden">
    <title>Secret</title>
    <description>Secret stuff</description>
</field>

换句话说，form:mode 可以是单个模式，也可以是空格分隔的 form_interface:mode 对的列表。

省略字段

可以使用 omitted 和 no_omit 指令完全省略字段，或从某些表单中省略字段。在此示例中，dummy 字段从所有表单中省略，而 edit_only 字段仅从提供 IEditForm 接口的表单中省略

from z3c.form.interfaces import IEditForm
from plone.supermodel import model
from plone.autoform import directives as form

class IMySchema(model.Schema):

    form.omitted('dummy')
    dummy = schema.Text(
        title=u"Dummy"
        )

    form.omitted('edit_only')
    form.no_omit(IEditForm, 'edit_only')
    edit_only = schema.TextLine(
        title = u'Only included on edit forms',
        )

在超级模型 XML 中，可以指定为

<field type="zope.schema.TextLine"
       name="dummy"
       form:omitted="true">
    <title>Dummy</title>
</field>

<field type="zope.schema.TextLine"
       name="edit-only"
       form:omitted="z3c.form.interfaces.IForm:true z3c.form.interfaces.IEditForm:false">
    <title>Only included on edit form</title>
</field>

form:omitted 可以是单个布尔值，也可以是空格分隔的 form_interface:boolean 对的列表。

字段重排序

可以使用 order_before 和 order_after 指令影响字段在表单中的位置。在此示例中，尽管 not_last 字段是在后面定义的，但它被放置在 summary 字段之前

from plone.supermodel import model
from plone.autoform import directives as form

class IMySchema(model.Schema):

    summary = schema.Text(
        title=u"Summary",
        description=u"Summary of the body",
        readonly=True
        )

    form.order_before(not_last='summary')
    not_last = schema.TextLine(
        title=u"Not last",
        )

传递给指令的值可以是“*”（表示所有字段之前或之后）或另一个字段的名称。使用'.fieldname'来引用当前架构或基础架构中的字段。使用架构名称（例如'IDublinCore.title'）作为前缀来引用另一个架构中的字段。使用无前缀的名称来引用当前或表单的默认架构中的字段。

在supermodel XML中，指令称为form:before和form:after。例如

<field type="zope.schema.TextLine"
       name="not_last"
       form:before="*">
    <title>Not last</title>
</field>

将字段组织到字段集中

字段可以被分组到字段集中，这些字段集将在HTML的<fieldset>标签中渲染。在这个例子中，footer和dummy字段被放置在extra字段集中

from plone.supermodel import model
from plone.autoform import directives as form

class IMySchema(model.Schema):

    model.fieldset('extra',
        label=u"Extra info",
        fields=['footer', 'dummy']
        )

    footer = schema.Text(
        title=u"Footer text",
        )

    dummy = schema.Text(
        title=u"Dummy"
        )

在supermodel XML中，字段集是通过在<fieldset>标签内分组字段来指定的

<fieldset name="extra" label="Extra info">
    <field name="footer" type="zope.schema.TextLine">
        <title>Footer text</title>
    </field>
    <field name="dummy" type="zope.schema.TextLine">
        <title>Dummy</title>
    </field>
</fieldset>

改变字段的部件

通常，z3c.form根据字段类型选择小部件。如果您想以不同的格式让用户输入或查看数据，可以使用widget指令来更改小部件。例如，在这里，我们将human字段的小部件更改为使用是/否单选按钮而不是复选框

from plone.supermodel import model
from plone.autoform import directives as form
from z3c.form.browser.radio import RadioFieldWidget

class IMySchema(model.Schema):
    form.widget('human', RadioFieldWidget)
    human = schema.Bool(
        title = u'Are you human?',
        )

您还可以传递小部件参数来控制小部件的属性。例如，在这里，我们保持默认小部件，但设置了一个CSS类

from plone.supermodel import model
from plone.autoform import directives as form
from z3c.form.browser.radio import RadioWidget

class IMySchema(model.Schema):
    form.widget('human', klass='annoying')
    human = schema.Bool(
        title = u'Are you human?',
        )

在supermodel XML中，小部件是通过使用<form:widget>标签来指定的，该标签可以有自己的元素来指定参数

<field name="human" type="zope.schema.TextLine">
    <title>Are you human?</title>
    <form:widget type="z3c.form.browser.radio.RadioWidget">
        <klass>annoying</klass>
    </form:widget>
</field>

注意：为了包含在架构的XML表示中，小部件参数必须由WidgetExportImportHandler实用工具处理。有一个默认的，它处理在z3c.form.browser.interfaces.IHTMLFormElement中定义的属性。

使用权限保护字段

默认情况下，字段无论用户的权限如何都会包含在表单中。可以使用read_permission和write_permission指令来保护字段。读取权限在字段处于显示模式时进行检查，写入权限在字段处于输入模式时进行检查。权限应使用其Zope 3风格的名称（即cmf.ManagePortal而不是“管理门户”）。

在这个例子中，secret字段被cmf.ManagePortal权限保护，作为读取和写入权限。这意味着在显示和输入模式下，只有具有该权限的用户才会将字段包含在表单中

from plone.supermodel import model
from plone.autoform import directives as form

class IMySchema(model.Schema):
    form.read_permission(secret='cmf.ManagePortal')
    form.write_permission(secret='cmf.ManagePortal')
    secret = schema.TextLine(
        title = u'Secret',
        )

在supermodel XML中，指令是security:read-permission和security:write-permission

<field type="zope.schema.TextLine"
       name="secret"
       security:read-permission="cmf.ManagePortal"
       security:write-permission="cmf.ManagePortal">
    <title>Secret</title>
</field>