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。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。