django-fsforms 6.0.0rc2

要求

• Python3
• django 1.11或2.0（尚不支持jinja2）
• 站点6.x的基础

请注意，此应用程序不包括站点资产的基础 以便您可以根据需要自定义它。从阅读它开始 documentation！

功能

• 显示字段标签及其帮助文本
• 在Forms component之后呈现django基小部件 指南
• 根据需要显示字段错误并设置正确的css类 字段标签和输入

安装

1. 安装django的基础模板：

   pip install django-fsforms
   

2. 将它添加到settings.py中的INSTALLED_APPS：

   INSTALLED_APPS=(...'fsforms',...)

3. 将settings.py中的FORM_RENDERER设置为使用fsforms。 一：

   • 如果您使用的是django模板：

     FORM_RENDERER='fsforms.renderers.DjangoTemplates'

   • 如果使用TemplateSetting作为表单呈现程序，则 必须确保fsforms模板的来源 在内置widgets模板目录之前。

   注意这个步骤是必需的，因为django正在加载模板 首先从^{tt8}中的内置表单模板目录$ 使用这些后端时（请参见Built-in-template form renderers’ doc）。

用法

在模板中，只需加载fsforms，然后使用 fsfield标记以呈现窗体字段。

{%loadfsforms%}

<form action="/url/to/submit/" method="post">
  {%csrf_token%}
  <ul class="no-bullet">
    <li>{%fsfieldform.simple_field%}</li>
    <li>{%fsfieldform.other_fieldlabel_class="my-field"%}</li>
  </ul>
  <div class="button-holder">
    <button type="submit" class="button">Submit</button>
  </div>
</form>

以下是可以传递给fsfield标记的特殊参数： show_label：打开或关闭标签输出的布尔值。注意 选择小部件的标签将始终显示。- label_class：包含要应用的其他css类的字符串 到label元素。-show_errors：打开或关闭的布尔值 字段错误的输出以及应用于 元素-例如is-invalid-input和is-invalid-label。默认 是True。-as_list：一个布尔值，用于控制 选择小部件-即radioselect和checkboxselectmultiple。设置时 到True-默认情况下，字段将内联呈现，并且 按照forms组件的建议包装在字段集中。 否则，它们将作为列表呈现。

其余所有参数都将添加到小部件属性中。作为 对于requiredone，您也可以更改它的值，但只能使用 客户副作用。这意味着如果字段定义为 表单类并将required=False传递给标记，它将 对用户显示为非必需，但仍将在 表格提交。

许可证

您可以在gnu agplv3+下使用它。参见LICENSE文件 细节。

更改日志

[未发布]

[6.0.0rc2]-2018-04-11

已添加

• fsfield标记以使用基础窗体呈现窗体字段 结构。