You need to enable JavaScript to run this app. 如何在Wagtail HTML模板中使用routablepageurl模板标签
优惠活动
大模型
产品
解决方案
定价
更多

如何在Wagtail HTML模板中使用routablepageurl模板标签

问题1解答

routablepageurl 是声明了 takes_context=True 的Django模板标签,context 参数不需要你手动传入,Django在渲染模板的时候会自动将当前模板的上下文对象作为第一个参数注入,所以你在模板中调用标签的时候完全感知不到这个参数的存在。

问题2解答

  • page 参数:你自己定义的、继承了 RoutablePageMixin 的页面类的实例对象,比如项目里的博客列表页 BlogPage 继承了 RoutablePageMixin,那模板中拿到的 BlogPage 实例就是要传入的 page 参数。
  • url_name 参数:你在页面类中用 @route 装饰器定义子路由时设置的 name 属性值,比如你写了 @route(r'^category/([-\w]+)/$', name='post_by_category'),那么 url_name 就是 post_by_category。

你找不到 subpage_urls 属性是正常的,这个属性是 RoutablePageMixin 自动生成的,它会自动收集你在页面类中定义的所有 @route 路由存到这个属性里,不需要你手动声明。

问题3解答

这和Django reverse 方法需要传入动态参数的逻辑完全一致:如果你的子路由规则里定义了动态捕获的参数,生成URL的时候就必须传入对应参数的值来补全路由。
比如示例里的路由规则匹配的是 /category/分类slug/ 格式的路径,category.slug 就是用来填充路由里的动态占位部分的,传了之后才能生成完整的可访问的分类页URL,缺了这个参数会因为路由匹配失败报错。


内容的提问来源于stack exchange,提问作者Yan Tian

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 16:51:04