Flask/WTF中如何读取Checkbox的value属性文本值而非布尔值

问题原因 #

WTForms 内置的 BooleanField 设计逻辑就是忽略前端提交的value属性值：只要该字段出现在提交的表单数据中就返回True，未提交就返回False，所以你前端设置的value值默认不会被读取。

解决方案1：利用表单生成顺序映射（最适合你的场景，无需修改表单结构） #

你在prefilter_import视图中是严格按照db_columns的顺序逐行添加表单项的，所以postfilter_import中form.rows的索引和db_columns的索引是完全一一对应的，直接通过索引取对应列名即可：

for i, row in enumerate(form.rows):
    if row.use.data:
        # 直接通过索引取对应数据库列名
        mappings[db_columns[i]] = row.sel.data

这个方案不需要修改任何表单定义，也不需要依赖前端提交的value值，完全规避硬编码问题，后续数据库schema变更时也不需要调整代码。

解决方案2：自定义字段读取前端value值 #

如果你确实需要直接读取前端设置的value属性内容，可以自定义一个布尔字段替换原生的BooleanField，重写表单数据处理逻辑：

from wtforms import Field
from wtforms.widgets import CheckboxInput

class ValueBooleanField(Field):
    widget = CheckboxInput()
    
    def process_formdata(self, valuelist):
        # 选中时valuelist会包含前端提交的value值，未选中时valuelist为空
        if valuelist:
            self.data = valuelist[0]
        else:
            self.data = False

然后修改你的子表单定义，把BooleanField替换为自定义字段：

class ImportFilterSubForm(Form):
    use = ValueBooleanField(
        'Use', 
        render_kw={'class': 'use'}
    )
    # 其余字段保持不变

修改后row.use.data在复选框选中时会直接返回你设置的列名字符串，未选中时返回False，你的原有业务逻辑无需调整即可正常运行。

内容的提问来源于stack exchange，提问作者Darwin von Corax