如何在Django的CharField上添加占位符?


195

以这个非常简单的形式为例:

class SearchForm(Form):
    q = forms.CharField(label='search')

这将在模板中呈现:

<input type="text" name="q" id="id_q" />

但是,我想将placeholder属性值添加到此字段,Search以便HTML看起来像这样:

<input type="text" name="q" id="id_q" placeholder="Search" />

最好我想CharField通过字典或类似的东西将占位符值传递给表单类中的:

q = forms.CharField(label='search', placeholder='Search')

做到这一点的最佳方法是什么?

Answers:


281

查看小部件文档。基本上看起来像:

q = forms.CharField(label='search', 
                    widget=forms.TextInput(attrs={'placeholder': 'Search'}))

是的,更多的写作,但是分离允许更好地抽象更复杂的情况。

您也可以声明widgets包含一个属性<field name> => <widget instance>直接映射Meta你的ModelForm子类。


您需要指定forms.TextInput进行attrs={'placeholder': 'Search'}声明吗?
JhovaniC

1
@OvedD,我知道这是老了,但看到这样的疑问:stackoverflow.com/questions/4341739/...
NotSimon

1
@OvedD:看看我的回答如何使用ModelForm
Hamish Downer

1
您必须指定一个小部件以添加占位符是非常愚蠢的。您应该能够编辑窗口小部件属性而不会覆盖整个窗口小部件...
dspacejs

对于中文,您需要像这样的前面的u:{'placeholder':u'搜索'}
shellbye 17-10-14

60

对于ModelForm,您可以这样使用Meta类:

from django import forms

from .models import MyModel

class MyModelForm(forms.ModelForm):
    class Meta:
        model = MyModel
        widgets = {
            'name': forms.TextInput(attrs={'placeholder': 'Name'}),
            'description': forms.Textarea(
                attrs={'placeholder': 'Enter description here'}),
        }

请注意,在这种情况下,您无法在类主体中指定字段。
2016年

这对我来说是最简单的方法-很好的是,所有其他属性(即必需属性)仍然可以自动添加,而无需我指定它们。
JxAxMxIxN

41

其他方法都很好。但是,如果您不想指定该字段(例如,对于某些动态方法),则可以使用以下方法:

def __init__(self, *args, **kwargs):
    super(MyForm, self).__init__(*args, **kwargs)
    self.fields['email'].widget.attrs['placeholder'] = self.fields['email'].label or 'email@address.nl'

它还允许占位符依赖于具有指定实例的ModelForms的实例。


7
这很棒,因为它避免了为复杂的对象(例如)复制控件的冗长实例化ModelMultipleChoiceField。谢谢!
donturner 2014年

1
类似的精神:for f in MyCommentForm.base_fields.values(): f.widget.attrs["placeholder"] = f.label,但我更喜欢您的构造方法。
jozxyqk 2014年

21

您可以使用此代码为表单中的每个TextInput字段添加占位符attr。占位符的文本将从模型字段标签中获取。

class PlaceholderDemoForm(forms.ModelForm):
    def __init__(self, *args, **kwargs):
        super(PlaceholderDemoForm, self).__init__(*args, **kwargs)
        for field_name in self.fields:
            field = self.fields.get(field_name)  
            if field:
                if type(field.widget) in (forms.TextInput, forms.DateInput):
                    field.widget = forms.TextInput(attrs={'placeholder': field.label})

    class Meta:
        model = DemoModel

19

好问题。我知道三种解决方案:

解决方案1

替换默认的小部件。

class SearchForm(forms.Form):  
    q = forms.CharField(
            label='Search',
            widget=forms.TextInput(attrs={'placeholder': 'Search'})
        )

解决方案#2

自定义默认窗口小部件。如果您使用的是该字段通常使用的同一小部件​​,则可以简单地自定义该小部件,而不用实例化一个全新的小部件。

class SearchForm(forms.Form):  
    q = forms.CharField(label='Search')

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.fields['q'].widget.attrs.update({'placeholder': 'Search'})

解决方案#3

最后,如果您正在使用模型表单,那么(除了前两个解决方案之外),您可以选择通过设置widgets内部Meta类的属性来为字段指定自定义窗口小部件。

class CommentForm(forms.ModelForm):  
    class Meta:
        model = Comment
        widgets = {
            'body': forms.Textarea(attrs={'cols': 80, 'rows': 20})
        }

1
我正要写一个解决方案,就像您的#2。我想补充一下,您可以通过迭代遍历所有字段self.fields,例如:for field_name in self.fields: self.fields[field_name].widget.attrs.update({"placeholder": sth})
Alberto Chiusole

@AlbertoChiusole是的,如果您要这样做,可以。感谢您指出。
Dwayne Crooks,

@DwayneCrooks我建议您按照cdosborn的解决方案更新您的#3 ,因为它更短且更易读。
玛丽安

1

当您只想覆盖其占位符时,不知道如何实例化窗口小部件是不可取的。

    q = forms.CharField(label='search')
    ...
    q.widget.attrs['placeholder'] = "Search"

0

大多数时候,我只是希望所有占位符都等于模型中定义的字段的详细名称

我添加了一个mixin,可以轻松地对我创建的任何表单执行此操作,

class ProductForm(PlaceholderMixin, ModelForm):
    class Meta:
        model = Product
        fields = ('name', 'description', 'location', 'store')

class PlaceholderMixin:
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs):
        field_names = [field_name for field_name, _ in self.fields.items()]
        for field_name in field_names:
            field = self.fields.get(field_name)
            field.widget.attrs.update({'placeholder': field.label})

-2

在查看了您的方法之后,我使用了这种方法来解决它。

class Register(forms.Form):
    username = forms.CharField(label='用户名', max_length=32)
    email = forms.EmailField(label='邮箱', max_length=64)
    password = forms.CharField(label="密码", min_length=6, max_length=16)
    captcha = forms.CharField(label="验证码", max_length=4)

def __init__(self, *args, **kwargs):
    super().__init__(*args, **kwargs)
    for field_name in self.fields:
        field = self.fields.get(field_name)
        self.fields[field_name].widget.attrs.update({
            "placeholder": field.label,
            'class': "input-control"
        })

2
请注意,内容在堆栈溢出时必须为英文。除此之外,这似乎是“我也是”的帖子,而不是上述问题的答案。
TylerH

我想说,“我也是”帖子如果添加更多细节也可以。这种方法与其他方法有什么不同?这是什么技术或基本学习?
半夜
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.