如何自定义与翻译Django PasswordChangeForm的错误提示信息
改密码表单英文错误提示的落地解决方法
你遇到的英文错误提示来自Django内置密码修改表单、密码校验逻辑的默认硬编码英文文案,不属于自定义字段配置的范畴,可通过两种方式实现中文/自定义语言的展示:
方案1:开启Django内置国际化翻译(推荐,无遗漏)
该方案直接调用Django官方维护的多语言文案包,无需逐行修改错误提示,所有内置的密码校验、表单字段错误都会自动匹配对应语言。
- 在项目配置文件
settings.py中做如下修改:
配置生效后,所有内置的表单错误(比如“原密码不正确”“两次输入密码不一致”“密码长度不足”等提示)都会自动替换为对应语言的翻译,不需要在表单里额外写自定义错误。# 替换原有语言配置 LANGUAGE_CODE = 'zh-hans' USE_I18N = True # 在MIDDLEWARE配置列表中,确保LocaleMiddleware的位置在SessionMiddleware之后、CommonMiddleware之前 MIDDLEWARE = [ 'django.middleware.security.SecurityMiddleware', 'django.contrib.sessions.middleware.SessionMiddleware', 'django.middleware.locale.LocaleMiddleware', 'django.middleware.common.CommonMiddleware', # 其余原有中间件按顺序保留即可 ]
方案2:逐字段覆盖自定义错误文案(适合非通用语言场景)
如果不需要全局国际化,只针对当前改密码表单替换成自定义语言文案,可在原有PasswordChangingForm类中覆盖内置的校验逻辑、错误提示:
from django.contrib.auth.forms import PasswordChangeForm from django import forms from django.contrib.auth import password_validation class PasswordChangingForm(PasswordChangeForm): old_password = forms.CharField( widget=forms.PasswordInput(attrs={'class': 'form-control', 'type':'password'}), error_messages={ 'required': '请输入原密码', } ) new_password1 = forms.CharField( max_length=100, widget=forms.PasswordInput(attrs={'class': 'form-control', 'type':'password'}), error_messages={ 'required': '请输入新密码', } ) new_password2 = forms.CharField( max_length=100, widget=forms.PasswordInput(attrs={'class': 'form-control', 'type':'password'}), error_messages={ 'required': '请再次输入新密码', } ) # 覆盖内置的旧密码校验错误 def clean_old_password(self): old_password = self.cleaned_data["old_password"] if not self.user.check_password(old_password): # 可将下方文案替换为你需要的自定义语言内容 raise forms.ValidationError("原密码输入错误") return old_password # 覆盖内置的两次密码一致性校验、密码强度校验错误 def clean_new_password2(self): password1 = self.cleaned_data.get('new_password1') password2 = self.cleaned_data.get('new_password2') if password1 and password2 and password1 != password2: raise forms.ValidationError("两次输入的新密码不一致") # 处理密码强度校验的提示替换 try: password_validation.validate_password(password2, self.user) except forms.ValidationError: raise forms.ValidationError("新密码不符合格式要求") return password2 class Meta: model = CustomUser fields = ('old_password','new_password1', 'new_password2')
模板侧优化提示
你当前模板中直接展示{{ form.errors }}的写法会把所有错误集中堆砌,可调整为逐字段匹配错误展示,提升页面可读性:
<!-- 把原来的{{ form.errors }}替换成每个字段下的独立错误块 --> <div class="col-sm-8"> {{ form.old_password }} {% if form.old_password.errors %} <div class="text-danger mt-1">{{ form.old_password.errors.0 }}</div> {% endif %} </div> <!-- 新密码、确认密码字段按上述逻辑逐一绑定对应错误展示即可 -->
内容的提问来源于stack exchange,提问作者chuluunhvv Nyamjaw
相关产品推荐
相关产品推荐

