rt.zptformfield 0.2.1

附加参数

fieldType（默认为“text”）

用于填充列表的HTML输入字段的类型。您可以将其更改为HTML 5新元素类型以使用一些浏览器原生功能。

pattern

HTML 5模式属性，用于字段验证。此正则表达式用于在将其添加到列表之前验证字段值。

elements

要用于填充列表的现有元素。提供一系列包含“title”和“value”对的字典。

如何使用

调用宏

<tal:field define="fieldName string:test_lines_field;
                   fieldLabel string:Testing lines field;
                   fieldHelp string:Write something, then add it;
                   ">
    <metal:field-content use-macro="context/@@rt.zptformfield.lines/field" />
</tal:field>

您需要在最终HTML中包含JavaScript。

<metal:head fill-slot="javascript_head_slot">
    <metal:field-content use-macro="context/@@rt.zptformfield.lines/javascript_helpers" />
</metal:head>

附加参数

source（必填）

jQueryUI将调用以获取可选择元素的URL。此调用必须返回一个有效的包含“value”和“label”元素的JSON序列。

elements

要用于填充列表的现有元素。提供一系列包含“title”和“value”对的字典。

如何使用

调用宏

<tal:field define="fieldName string:test_lines_field;
                   source string:${portal_url}/@@rt.zptformfield.test.vocab;
                   fieldLabel string:Testing autocomplete field;
                   fieldHelp string:Write something and test the autocomplete feature;
                   ">
    <metal:field-content use-macro="context/@@rt.zptformfield.autocomplete_lines/field" />
</tal:field>

您需要在最终HTML中包含JavaScript。

<metal:head fill-slot="javascript_head_slot">
    <metal:field-content use-macro="context/@@rt.zptformfield.autocomplete_lines/javascript_helpers" />
</metal:head>

附加参数

rows

textarea的行数

cols

textarea的列数

configuration_method

用于获取TinyMCE配置的视图。不要用于加载默认配置

configuration_json

直接提供JSON配置。不要用于从“configuration_method”加载

value

字段中的默认文本

如何使用

调用宏

<tal:field define="fieldName string:test_lines_field;
                   fieldLabel string:Testing TinyMCE field;
                   fieldHelp string:You can use the WYSIWYG editor below;
                   rows python:15;
                   value string:The cat is on the table;
                   ">
    <metal:field-content use-macro="context/@@rt.zptformfield.tinymce/field" />
</tal:field>

附加参数

startup_directory

开始浏览网站的目录。默认为当前上下文。

context_helper

调用refbrowserhelper视图的上下文。默认为当前上下文。

fake_field_name（必填）

此字段名称在表单中不会使用，但必须是“context_helper”定义的上下文中的一个现有Archetypes引用字段名称。

search_index

用于覆盖搜索框的TextIndex。默认为Plone默认的“SearchableText”。

如何使用

调用宏

<tal:field define="fieldName string:test_reference_field;
                   fake_field_name string:foo_field;
                   fieldLabel string:Testing reference browser field;
                   fieldHelp string:Use the Plone reference browser feature.
                   ">
    <metal:field-content use-macro="context/@@rt.zptformfield.reference/field" />
</tal:field>

在上面的示例中，我们没有提供context_helper参数，因此它必须在表现“foo_field”单值引用字段的Plone内容上调用。

您需要在最终HTML中包含JavaScript。

<metal:head fill-slot="javascript_head_slot">
    <metal:field-content use-macro="context/@@rt.zptformfield.reference/javascript_helpers" />
</metal:head>

附加参数

参见“引用字段”

如何使用

调用宏

<tal:field define="fieldName string:test_multivalued_reference_field;
                   fake_field_name string:relatedItems;
                   fieldLabel string:Testing multivalued reference browser field;
                   fieldHelp string:Use the Plone reference browser feature.
                   ">
    <metal:field-content use-macro="context/@@rt.zptformfield.multivalued_reference/field" />
</tal:field>

在上面的示例中，我们没有提供context_helper参数，因此它必须在表现“relatedItems”多值引用字段（默认：所有内容类型）的Plone内容上调用。

您需要在最终HTML中包含JavaScript。

<metal:head fill-slot="javascript_head_slot">
    <metal:field-content use-macro="context/@@rt.zptformfield.multivalued_reference/javascript_helpers" />
</metal:head>

附加参数

value

要显示的日期（一个Zope DateTime对象）。默认情况下将不显示任何日期。

show_hm

显示小时/分钟小部件元素的布尔值。默认情况下将显示它们。

show_ymd

显示日期小部件元素的布尔值。默认情况下将显示它们。

starting_year

定义年份组合框中第一个年份的整数值。

ending_year

定义年份组合框中最后一个年份的整数值。

future_years

定义在日历小部件中显示多少年（从当前日期起）。如果提供了ending_year，则将被忽略。

minute_step

如果显示分钟组合框，则定义分钟值之间的间隔。Plone默认值为5。

calendar_lang

日历弹出UI的语言。由于一个老的和永远不会修复的Plone错误，默认设置为英语，而不是当前语言。自行承担风险。此外：请注意，此参数是针对javascript_helpers宏（请参见下面的示例）。

如何使用

调用宏

<tal:field define="fieldName string:test_calendar_field;
                   fieldLabel string:Testing Calendar field;
                   fieldHelp string:The standard Plone calendar;">
    <metal:field-content use-macro="context/@@rt.zptformfield.calendar/field" />
</tal:field>

您需要在最终的HTML中包含JavaScript。关于使用calendar_lang参数的另一个警告：它是存在错误的。

<metal:head fill-slot="javascript_head_slot" tal:define="calendar_lang context/@@plone_portal_state/language;">
    <metal:field-content use-macro="context/@@rt.zptformfield.calendar/javascript_helpers" />
</metal:head>

最后，日历弹出需要一些CSS样式。

<metal:head fill-slot="style_slot">
    <link rel="stylesheet" type="text/css" href="jscalendar/calendar-system.css"
          tal:attributes="href string:$portal_url/jscalendar/calendar-system.css" />
</metal:head>