Django中TextField实现每4位空格分隔的IBAN格式方法求助

试试这几种实用方法，不管是后端处理还是前端实时格式化都能搞定：

后端层面（提交/存储时格式化） #

1. 重写表单的clean方法 #

在表单字段的clean方法里处理输入，先清理空格再重新格式化，同时做长度验证：

from django import forms

class YourIBANForm(forms.Form):
    iban = forms.CharField(widget=forms.TextInput(attrs={'placeholder': 'XXXX XXXX XXXX XXXX'}))

    def clean_iban(self):
        raw_iban = self.cleaned_data.get('iban', '').replace(' ', '')
        # 验证长度是否为16位纯数字
        if len(raw_iban) != 16 or not raw_iban.isdigit():
            raise forms.ValidationError("请输入16位纯数字的IBAN")
        # 每4位插入空格
        formatted_iban = ' '.join([raw_iban[i:i+4] for i in range(0, len(raw_iban), 4)])
        return formatted_iban

2. 模型层处理保存逻辑 #

如果希望数据库里存的就是格式化后的内容，可以重写模型的save方法：

from django.db import models

class YourModel(models.Model):
    iban = models.CharField(max_length=19)  # 16位数字+3个空格，总长度19

    def save(self, *args, **kwargs):
        # 先清理所有空格
        clean_iban = self.iban.replace(' ', '')
        if len(clean_iban) == 16 and clean_iban.isdigit():
            self.iban = ' '.join([clean_iban[i:i+4] for i in range(0, 16, 4)])
        super().save(*args, **kwargs)

前端实时格式化（提升用户体验） #

用户输入时自动添加空格，不用等提交就能看到格式效果，配合后端验证更稳妥：

<!-- 模板中对应的输入框及脚本 -->
<input type="text" id="iban-input" maxlength="19" placeholder="XXXX XXXX XXXX XXXX">
<script>
const ibanInput = document.getElementById('iban-input');
ibanInput.addEventListener('input', function(e) {
    // 过滤掉所有非数字字符
    let pureNum = e.target.value.replace(/\D/g, '');
    // 每4位分割并加空格
    let formatted = pureNum.match(/.{1,4}/g)?.join(' ') || '';
    e.target.value = formatted;
});
</script>

注意：前端只是优化体验，后端必须做验证和格式化，防止用户绕过前端提交非法内容。

自定义IBAN表单字段 #

如果想封装成可复用的字段，直接自定义一个：

from django.forms import CharField, TextInput

class IBANField(CharField):
    widget = TextInput(attrs={'placeholder': 'XXXX XXXX XXXX XXXX', 'maxlength': '19'})

    def clean(self, value):
        value = super().clean(value).replace(' ', '')
        if len(value) != 16 or not value.isdigit():
            raise self.error_messages['invalid']
        return ' '.join([value[i:i+4] for i in range(0, 16, 4)])

# 表单中使用
class YourForm(forms.Form):
    iban = IBANField(error_messages={'invalid': '请输入有效的16位数字IBAN'})

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