Django Form Utils 技术文档
安装指南
安装方式
-
使用
pip
安装django-form-utils
:pip install django-form-utils
-
在 Django 项目的
settings.py
文件中,将form_utils
添加到INSTALLED_APPS
列表中:INSTALLED_APPS = [ ... 'form_utils', ... ]
依赖项
django-form-utils
支持 Django 1.4 及以上版本,Python 2.6、2.7 和 3.3。ImageWidget
需要Python Imaging Library
。AutoResizeTextarea
需要jQuery
。
项目使用说明
BetterForm 和 BetterModelForm
BetterForm
和 BetterModelForm
是 django.forms.Form
和 django.forms.ModelForm
的子类,允许将表单划分为多个字段集(fieldsets),并在模板中迭代这些字段集。还可以为每个字段定义 row_attrs
,以便在模板中为字段容器添加属性。
示例
from form_utils.forms import BetterForm
class MyForm(BetterForm):
one = forms.CharField()
two = forms.CharField()
three = forms.CharField()
class Meta:
fieldsets = [
('main', {'fields': ['two'], 'legend': ''}),
('Advanced', {'fields': ['three', 'one'], 'description': 'advanced stuff', 'classes': ['advanced', 'collapse']})
]
row_attrs = {'one': {'style': 'display: none'}}
字段集(Fieldsets)
字段集定义类似于 ModelAdmin
的字段集定义。每个字段集是一个包含名称和选项字典的二元组。选项字典中的有效选项包括:
fields
:必填,字段名称的元组。classes
:应用于字段集的额外 CSS 类。legend
:字段集的标题。description
:字段集的描述文本。
行属性(Row Attributes)
row_attrs
是一个字典,映射字段名称到属性值字典。属性值字典将被展平为 HTML 样式的属性值对,并作为 row_attrs
属性提供给 BoundField
。
渲染
可以使用以下模板来渲染 BetterForm
:
{% if form.non_field_errors %}{{ form.non_field_errors }}{% endif %}
{% for fieldset in form.fieldsets %}
<fieldset class="{{ fieldset.classes }}">
{% if fieldset.legend %}
<legend>{{ fieldset.legend }}</legend>
{% endif %}
{% if fieldset.description %}
<p class="description">{{ fieldset.description }}</p>
{% endif %}
<ul>
{% for field in fieldset %}
{% if field.is_hidden %}
{{ field }}
{% else %}
<li{{ field.row_attrs }}>
{{ field.errors }}
{{ field.label_tag }}
{{ field }}
</li>
{% endif %}
{% endfor %}
</ul>
</fieldset>
{% endfor %}
项目 API 使用文档
实用模板过滤器
django-form-utils
提供了一些有用的模板过滤器,帮助模板作者在不修改 Python 代码的情况下自定义表单渲染。
label
渲染给定表单字段的标签标签。默认使用 Python 定义的标签文本,但可以通过过滤器参数提供备用标签文本。
{{ form.fieldname|label:"Alternate label" }}
value_text
以人类可读的方式显示给定表单字段的当前值。
{{ form.fieldname|value_text }}
selected_values
类似于 value_text
,但用于多选表单字段,返回选定值的列表。
<ul>
{% for selected_value in form.multiselect|selected_values %}
<li>{{ selected_value }}</li>
{% endfor %}
</ul>
optional
如果给定字段是可选的,则返回 True
,否则返回 False
。
{% if form.fieldname|optional %}(optional){% endif %}
is_checkbox
如果给定字段的控件是 CheckboxInput
,则返回 True
,否则返回 False
。
{% if form.fieldname|is_checkbox %}
{{ form.fieldname }}
{{ form.fieldname|label }}
{% else %}
{{ form.fieldname|label }}
{{ form.fieldname }}
{% endif %}
is_multiple
如果给定字段是 MultipleChoiceField
,则返回 True
,否则返回 False
。
{% if form.fieldname|is_multiple %}
{% for value in form.fieldname|selected_values %}{{ value }} {% endif %}
{% else %}
{{ form.fieldname|value_text }}
{% endif %}
项目安装方式
使用 pip 安装
pip install django-form-utils
添加到 INSTALLED_APPS
在 settings.py
中添加 form_utils
:
INSTALLED_APPS = [
...
'form_utils',
...
]
自定义模板
可以通过提供自定义模板来覆盖默认的表单渲染模板:
templates/form_utils/better_form.html
templates/form_utils/form.html
- DDeepSeek-V3.1-BaseDeepSeek-V3.1 是一款支持思考模式与非思考模式的混合模型Python00
- QQwen-Image-Edit基于200亿参数Qwen-Image构建,Qwen-Image-Edit实现精准文本渲染与图像编辑,融合语义与外观控制能力Jinja00
GitCode-文心大模型-智源研究院AI应用开发大赛
GitCode&文心大模型&智源研究院强强联合,发起的AI应用开发大赛;总奖池8W,单人最高可得价值3W奖励。快来参加吧~042CommonUtilLibrary
快速开发工具类收集,史上最全的开发工具类,欢迎Follow、Fork、StarJava04GitCode百大开源项目
GitCode百大计划旨在表彰GitCode平台上积极推动项目社区化,拥有广泛影响力的G-Star项目,入选项目不仅代表了GitCode开源生态的蓬勃发展,也反映了当下开源行业的发展趋势。06GOT-OCR-2.0-hf
阶跃星辰StepFun推出的GOT-OCR-2.0-hf是一款强大的多语言OCR开源模型,支持从普通文档到复杂场景的文字识别。它能精准处理表格、图表、数学公式、几何图形甚至乐谱等特殊内容,输出结果可通过第三方工具渲染成多种格式。模型支持1024×1024高分辨率输入,具备多页批量处理、动态分块识别和交互式区域选择等创新功能,用户可通过坐标或颜色指定识别区域。基于Apache 2.0协议开源,提供Hugging Face演示和完整代码,适用于学术研究到工业应用的广泛场景,为OCR领域带来突破性解决方案。00openHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!C0300- WWan2.2-S2V-14B【Wan2.2 全新发布|更强画质,更快生成】新一代视频生成模型 Wan2.2,创新采用MoE架构,实现电影级美学与复杂运动控制,支持720P高清文本/图像生成视频,消费级显卡即可流畅运行,性能达业界领先水平Python00
- GGLM-4.5-AirGLM-4.5 系列模型是专为智能体设计的基础模型。GLM-4.5拥有 3550 亿总参数量,其中 320 亿活跃参数;GLM-4.5-Air采用更紧凑的设计,拥有 1060 亿总参数量,其中 120 亿活跃参数。GLM-4.5模型统一了推理、编码和智能体能力,以满足智能体应用的复杂需求Jinja00
Yi-Coder
Yi Coder 编程模型,小而强大的编程助手HTML013
热门内容推荐
最新内容推荐
项目优选









