自定义Wagtail的wagtailadmin/templates/shared/field.html模板为何引发测试报错？

错误原因 #

你在模板里使用{% icon %}标签时传入了classname参数，但当前Wagtail版本的icon标签并不支持这个参数名，触发了模板语法错误。

修复方案 #

• 适配Wagtail新版本（2.15及以上）：
  该版本的icon标签接受**classnames**（复数形式）参数来指定图标CSS类，把模板里的classname替换为classnames即可。
  示例修改：
  原代码：{% icon "some-icon" classname="icon-large" %}
  修改后：{% icon "some-icon" classnames="icon-large" %}

• 适配Wagtail旧版本：
  更早版本的icon标签不支持自定义类名参数，可将类名添加到图标外层的HTML元素中，比如：

  <span class="icon-large">{% icon "some-icon" %}</span>
  

验证方法 #

修改模板后重新运行测试或启动服务，确认语法错误消失，确保所有icon标签的参数名与当前Wagtail版本匹配。

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