如何为Django的IntegerField设置占位符

问题背景 #

现有模型定义：

class Case(TimeStampedModel):
   id = models.UUIDField(
        primary_key=True, unique=True, default=uuid.uuid4, editable=False
    )

    user = models.ForeignKey(
        get_user_model(), blank=False, null=True, on_delete=models.SET_NULL)
    
    age = models.IntegerField("Age")
    SEX_CHOICES = [
                ("male", "Male"),
                ("female", "Female"),
                ('', "Sex")
    ]

    sex = models.CharField("Sex", max_length=20, choices=SEX_CHOICES, blank=False)

对应的ModelForm：

class CaseForm(ModelForm):
    class Meta:
        model = Case
        fields = ["sex", "age"]

sex字段通过choices实现了"Sex"占位效果，现在需要为age字段添加类似占位符，但尝试重新声明字段的方式后，age字段丢失了整数字段的行为特性：

class CaseForm(ModelForm):
    age = IntegerField(label='Age', widget=TextInput(attrs={'placeholder': 'Age'}))
    class Meta:
        model = Case
        fields = ["sex", "age"]

解决方案 #

方法一：通过Meta类的widgets属性配置 #

直接在Meta的widgets字典中为age字段指定带占位符的NumberInput（IntegerField默认的widget），既保留原字段的验证逻辑，又添加占位符：

from django import forms

class CaseForm(ModelForm):
    class Meta:
        model = Case
        fields = ["sex", "age"]
        widgets = {
            'age': forms.NumberInput(attrs={'placeholder': 'Age'}),
        }

方法二：在表单初始化方法中修改属性 #

如果需要更灵活的配置（比如根据动态条件设置占位符），可以在表单的__init__方法中更新字段的widget属性：

from django import forms

class CaseForm(ModelForm):
    class Meta:
        model = Case
        fields = ["sex", "age"]

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 为age字段添加占位符
        self.fields['age'].widget.attrs.update({'placeholder': 'Age'})

原因说明 #

之前的错误在于重新声明age = IntegerField(...)时，覆盖了ModelForm自动从模型生成的字段，丢失了原模型字段关联的验证规则，同时使用TextInput代替了IntegerField默认的NumberInput，导致浏览器层面丢失了数字输入特性（比如只能输入数字、移动端弹出数字键盘）。上述两种方法都是基于ModelForm自动生成的字段进行修改，不会破坏原有字段的行为逻辑。

内容的提问来源于stack exchange，提问作者RobMcC