django的表单设计器应用程序
django-formed的Python项目详细描述
#django formed
一个表单设计器,它可以创建具有字段集、行和每行多个字段的多页表单。还可以选择
摘要页、多个通知收件人、自动确认电子邮件和自定义表单字段。
表单的布局在可重写模板中处理。开发人员可以选择通过简单地打印表单、字段集、行或字段来自动呈现它们,或者通过迭代它们并打印每一位html本身来手动呈现它们。
wn头依赖项)
+[兼容性](降价头兼容性)
-[配置](降价头配置)
-[添加自定义表单字段](降价头添加自定义表单字段)
-[信用](降价头信用)
g formed是通过pypi完成的。
>安装后,通过运行迁移脚本创建所需的数据库表。
-[djang formed具有以下依赖项:
-[django](https://www.djangoproject.com/)*duh..*,至少版本1.6.11和&;lt;=1.9
-[jsonfield](https://github.com/bradjasper/django-jsonfield)1.0.3
配置,但允许开发人员进行大量自定义。
以下是所有有用的设置:
-`formed_form_field_modules`,默认值:`(formed.form_fields,django.forms)`。定义应检查
表单字段的模块。
-`formed_session_name`,默认值:`'formed`。存储表单数据的会话密钥的名称。
-`formed_definition_default_field_type`,default:`charfield`。
\notifications
-`formed_notification_from_email`,default:`settings.default_from_email`。从中发送通知的电子邮件。
-`formed_notification_default_subject`,default:`"submission of form'{name}'"。通知电子邮件的主题。
可用的标记有:`{name}`:表单的名称,`{language}`当前语言,`{site}`当前
`site`对象(仅当"formed"使用"sites"框架`=`true')。
类`,默认值:`'is-error`。作为
[`error\u css\u class`]传递给django的form类(https://docs.djangoproject.com/en/1.9/ref/form s/api/`django.forms.form.error\u css\u class)
参数。
-`formed\u form\u required\u css\u class`,默认值:`'is-required`。传递给django的form类作为
[`Required\u css\u class`](https://docs.djangoproject.com/en/1.9/ref/form s/api/`django.forms.form.Required\u css\u class)
参数。
-`formed\u form\u optional\u css\u class`,默认值:`'is-optional`。不是真正的django表单类参数,但当该字段是可选的时,该类会添加到表单字段容器中。之所以存在此设置,是因为实际上
大多数字段都是必需的。不是可选的。
-‘formed_form_label_suffix `,default `'。传递给django的form类作为
[`label戋suffix`](https://docs.djangoproject.com/en/1.9/ref/form s/api/戋django.forms.form.label戋suffix)参数。
-`formed戋form戋required戋label戋suffix`,默认值:`none`。需要字段时添加到标签上的后缀。
-`form_form_optional_label_suffix`,默认值:`````('(可选)``)。当一个字段是可选的时添加的后缀。
是否在管理中显示json字段的布尔值。
-`formed_additional_form_fields`,默认值:"{}"。附加表单域类型的字典。使用此选项可添加更多表单
字段。请参阅[添加自定义表单域](自定义表单域)。
-`formed_form_fields`,默认值:`formed.settings.defaults.formed_form_fields`。字段类型名为键的字典
,字段属性为值的字典。此设置覆盖**所有**可用表单字段。请参见
[添加自定义表单域]("自定义表单域"。
-`formed_form_field_categories`,默认值:`formed.settings.defaults.formed_form_field_categories`。一个字典
,其中键是类别名称,列表是字段类型。重写或扩展此设置以添加您自己的自定义
字段。请参阅[添加自定义表单域](自定义表单域)。
布尔值无论是否使用recaptcha选项
-`recaptcha_site_key`,默认值:`none`。由google提供的recaptcha site key,默认值为none。由google提供的recaptcha密钥
-`recaptcha_site_verify`,默认值:`https://www.google.com/recaptcha/api/sitevirify`。
第三方集成
–"formed_use_sites_framework",默认值为"settings.installed_apps"中的"django.contrib.sites"。是否将
站点表单字段添加到表单定义模型。
要添加自定义表单域,首先需要自定义域。只需在项目中创建一个新文件,例如
`form_fields.py`并创建表单字段。例如,您可以将一个现有字段子类化,并添加自己的
小部件。
````
!python
from django import forms
class mycustomcharfield(forms.charfield):
widget=mycustomwidget
```
有关如何创建表单字段的详细信息,请参见
[django文档](https://docs.djangoproject.com/en/1.9/ref/forms/fields/创建自定义-字段)。
**步骤2**。在您的设置中,将表单域模块添加到"表单域模块"。这允许formed实际找到您的自定义字段。
```
!!python
来自my_project import form_fields
formed_additional_form_fields_modules=[form_fields]
````
**步骤3**。在您的设置中,使用"formed_additional_form_fields"设置以确保编辑器知道如何处理您的表单字段。
```
!!python
formed_additional_form_fields={
"custom_text":{
"type"是字段的类名。
"type":"mycustomcharfield",
"表单编辑器"下拉列表中字段的名称。
"name":"custom text",
"com""ponent"用于管理中的表单编辑器。
"component":{
"component模板的名称:
"name":"text input",
"component模板中传递了其他参数:
"type":"text",
}
},
}
```
**第4步**。将字段添加到"formed_form_field_categories"字典中。这实际上是在字段
类型下拉列表中添加字段。
```
python
从formed.settings.defaults导入formed_form_field_categories
从django.utils.translation导入ugettext为formed_form_field_categories.update({
我们使用gettext使该类别可翻译,这不是必需的。
("我的自定义字段"):[
#这是formed_additional_form_fields变量中字段的键:
"自定义_文本",
]
}
```
>新字段现在在编辑器中可用,并将在模板中呈现。
credits
js库:
-[vue](https://vuejs.org/)用于编辑器。
-[sortable](https://github.com/rubaxa/sortable)用于拖放交互。
一个表单设计器,它可以创建具有字段集、行和每行多个字段的多页表单。还可以选择
摘要页、多个通知收件人、自动确认电子邮件和自定义表单字段。
表单的布局在可重写模板中处理。开发人员可以选择通过简单地打印表单、字段集、行或字段来自动呈现它们,或者通过迭代它们并打印每一位html本身来手动呈现它们。
wn头依赖项)
+[兼容性](降价头兼容性)
-[配置](降价头配置)
-[添加自定义表单字段](降价头添加自定义表单字段)
-[信用](降价头信用)
g formed是通过pypi完成的。
>安装后,通过运行迁移脚本创建所需的数据库表。
-[djang formed具有以下依赖项:
-[django](https://www.djangoproject.com/)*duh..*,至少版本1.6.11和&;lt;=1.9
-[jsonfield](https://github.com/bradjasper/django-jsonfield)1.0.3
配置,但允许开发人员进行大量自定义。
以下是所有有用的设置:
-`formed_form_field_modules`,默认值:`(formed.form_fields,django.forms)`。定义应检查
表单字段的模块。
-`formed_session_name`,默认值:`'formed`。存储表单数据的会话密钥的名称。
-`formed_definition_default_field_type`,default:`charfield`。
\notifications
-`formed_notification_from_email`,default:`settings.default_from_email`。从中发送通知的电子邮件。
-`formed_notification_default_subject`,default:`"submission of form'{name}'"。通知电子邮件的主题。
可用的标记有:`{name}`:表单的名称,`{language}`当前语言,`{site}`当前
`site`对象(仅当"formed"使用"sites"框架`=`true')。
类`,默认值:`'is-error`。作为
[`error\u css\u class`]传递给django的form类(https://docs.djangoproject.com/en/1.9/ref/form s/api/`django.forms.form.error\u css\u class)
参数。
-`formed\u form\u required\u css\u class`,默认值:`'is-required`。传递给django的form类作为
[`Required\u css\u class`](https://docs.djangoproject.com/en/1.9/ref/form s/api/`django.forms.form.Required\u css\u class)
参数。
-`formed\u form\u optional\u css\u class`,默认值:`'is-optional`。不是真正的django表单类参数,但当该字段是可选的时,该类会添加到表单字段容器中。之所以存在此设置,是因为实际上
大多数字段都是必需的。不是可选的。
-‘formed_form_label_suffix `,default `'。传递给django的form类作为
[`label戋suffix`](https://docs.djangoproject.com/en/1.9/ref/form s/api/戋django.forms.form.label戋suffix)参数。
-`formed戋form戋required戋label戋suffix`,默认值:`none`。需要字段时添加到标签上的后缀。
-`form_form_optional_label_suffix`,默认值:`````('(可选)``)。当一个字段是可选的时添加的后缀。
是否在管理中显示json字段的布尔值。
-`formed_additional_form_fields`,默认值:"{}"。附加表单域类型的字典。使用此选项可添加更多表单
字段。请参阅[添加自定义表单域](自定义表单域)。
-`formed_form_fields`,默认值:`formed.settings.defaults.formed_form_fields`。字段类型名为键的字典
,字段属性为值的字典。此设置覆盖**所有**可用表单字段。请参见
[添加自定义表单域]("自定义表单域"。
-`formed_form_field_categories`,默认值:`formed.settings.defaults.formed_form_field_categories`。一个字典
,其中键是类别名称,列表是字段类型。重写或扩展此设置以添加您自己的自定义
字段。请参阅[添加自定义表单域](自定义表单域)。
布尔值无论是否使用recaptcha选项
-`recaptcha_site_key`,默认值:`none`。由google提供的recaptcha site key,默认值为none。由google提供的recaptcha密钥
-`recaptcha_site_verify`,默认值:`https://www.google.com/recaptcha/api/sitevirify`。
第三方集成
–"formed_use_sites_framework",默认值为"settings.installed_apps"中的"django.contrib.sites"。是否将
站点表单字段添加到表单定义模型。
要添加自定义表单域,首先需要自定义域。只需在项目中创建一个新文件,例如
`form_fields.py`并创建表单字段。例如,您可以将一个现有字段子类化,并添加自己的
小部件。
````
!python
from django import forms
class mycustomcharfield(forms.charfield):
widget=mycustomwidget
```
有关如何创建表单字段的详细信息,请参见
[django文档](https://docs.djangoproject.com/en/1.9/ref/forms/fields/创建自定义-字段)。
**步骤2**。在您的设置中,将表单域模块添加到"表单域模块"。这允许formed实际找到您的自定义字段。
```
!!python
来自my_project import form_fields
formed_additional_form_fields_modules=[form_fields]
````
**步骤3**。在您的设置中,使用"formed_additional_form_fields"设置以确保编辑器知道如何处理您的表单字段。
```
!!python
formed_additional_form_fields={
"custom_text":{
"type"是字段的类名。
"type":"mycustomcharfield",
"表单编辑器"下拉列表中字段的名称。
"name":"custom text",
"com""ponent"用于管理中的表单编辑器。
"component":{
"component模板的名称:
"name":"text input",
"component模板中传递了其他参数:
"type":"text",
}
},
}
```
**第4步**。将字段添加到"formed_form_field_categories"字典中。这实际上是在字段
类型下拉列表中添加字段。
```
python
从formed.settings.defaults导入formed_form_field_categories
从django.utils.translation导入ugettext为formed_form_field_categories.update({
我们使用gettext使该类别可翻译,这不是必需的。
("我的自定义字段"):[
#这是formed_additional_form_fields变量中字段的键:
"自定义_文本",
]
}
```
>新字段现在在编辑器中可用,并将在模板中呈现。
credits
js库:
-[vue](https://vuejs.org/)用于编辑器。
-[sortable](https://github.com/rubaxa/sortable)用于拖放交互。