Python Django BoundField.label_tag用法及代码示例

本文介绍 django.forms.BoundField.label_tag 的用法。

声明

BoundField.label_tag(contents=None, attrs=None, label_suffix=None)

使用 Form.template_name_label 指定的模板为表单字段呈现标签标记。

可用的上下文是：

field ： BoundField 的这个实例。
contents ：默认情况下， BoundField.label 和 Form.label_suffix (或 Field.label_suffix ，如果设置)的串联字符串。这可以被contents 和label_suffix 参数覆盖。
attrs ：包含 for 、 Form.required_css_class 和 id 的 dict 。 id 由字段的小部件 attrs 或 BoundField.auto_id 生成。 attrs 参数可以提供其他属性。
use_tag ：如果标签具有 id ，则为 True 的布尔值。如果 False 默认模板省略 <label> 标记。

提示

在您的模板中 field 是 BoundField 的实例。因此 field.field 访问 BoundField.field 是您声明的字段，例如forms.CharField 。

要单独渲染表单域的标签标签，可以调用其label_tag()方法：

>>> f = ContactForm(data={'message': ''})
>>> print(f['message'].label_tag())
<label for="id_message">Message:</label>

如果您想自定义渲染，可以通过覆盖 Form.template_name_label 属性或更一般地通过覆盖默认模板来实现，另请参阅覆盖内置表单模板。

在 Django 4.0 中更改：

现在使用模板引擎呈现标签。

相关用法

注：本文由纯净天空筛选整理自djangoproject.com大神的英文原创作品 django.forms.BoundField.label_tag。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。