Django模板中如何访问QuerySet关联模型的字段属性如max_length
问题原因
Django模板系统存在安全访问限制,默认不允许访问名称以下划线开头的属性/方法,而模型字段的所有元数据(包括max_length、decimal_places等)都存储在模型类的_meta属性下。你在Shell、表单中可以直接调用_meta相关接口获取属性,是因为这些环境没有模板的访问拦截规则,因此直接在模板中写的访问路径都会被拦截返回空值。
可行实现方案
方案1:自定义模板过滤器(通用性最高,推荐)
适合多个模板、多个模型都需要读取字段属性的场景,一次定义全局复用。
- 首先在你的Django应用目录下新建
templatetags文件夹,在文件夹内新增空文件__init__.py,再新建自定义标签文件field_attr.py,写入以下代码:
from django import template register = template.Library() @register.filter def get_model_field_attr(model_cls, param): # 参数格式为 字段名,属性名 用逗号分隔 field_name, attr_name = param.split(",") try: field = model_cls._meta.get_field(field_name) return getattr(field, attr_name, "") except Exception: return ""
- 在需要使用属性的模板顶部引入自定义标签:
{% load field_attr %}
- 直接通过QuerySet的model属性调用过滤器取值即可,示例写法:
<!-- 取name字段的max_length --> {{ productlist.model|get_model_field_attr:"name,max_length" }} <!-- 取price字段的decimal_places --> {{ productlist.model|get_model_field_attr:"price,decimal_places" }}
方案2:视图提前注入上下文(单视图使用首选)
如果只需要在当前视图对应的模板中使用字段属性,不需要全局复用,可以直接在ListView中重写get_context_data方法,把需要的属性提前计算好放入上下文,不需要额外开发模板标签。
视图代码示例:
from django.views.generic import ListView from .models import Product class ProductSearch(ListView): # 你原有配置保持不变 model = Product context_object_name = "productlist" def get_context_data(self, **kwargs): context = super().get_context_data(**kwargs) # 提前把需要的字段属性放入上下文 context["product_field_attrs"] = { "name_max_length": Product._meta.get_field("name").max_length, "price_decimal_places": Product._meta.get_field("price").decimal_places, # 其他需要的字段属性可以在这里统一添加 } return context
模板中直接取值即可:
{{ product_field_attrs.name_max_length }} {{ product_field_attrs.price_decimal_places }}
方案3:模型层暴露自定义属性(单字段少量使用场景)
如果只需要读取个别字段的属性,也可以直接在模型类中定义公开的property属性,把字段属性暴露出来:
from django.db import models from .abstract import AbstractProduct class Product(AbstractProduct): # 你原有字段定义保持不变 name = models.CharField(max_length=100) price = models.DecimalField(max_digits=10, decimal_places=2) # 暴露需要的字段属性 @property def name_max_length(self): return self._meta.get_field("name").max_length @property def price_decimal_places(self): return self._meta.get_field("price").decimal_places
模板中可以通过单个Product实例直接取值:
{% for product in productlist %} {{ product.name_max_length }} {{ product.price_decimal_places }} {% endfor %}
内容的提问来源于stack exchange,提问作者Eric Muijs
相关产品推荐
相关产品推荐

