Grantlee模板引擎内置标签与过滤器详解

概述

Grantlee是一个基于Django模板语法的C++模板引擎，提供了丰富的内置标签和过滤器功能。本文将详细介绍Grantlee中的内置功能，包括从Django移植过来的标签和过滤器，以及Grantlee特有的扩展功能。

Django移植功能

Grantlee移植了Django 1.9版本中的大部分内置标签和过滤器，使得熟悉Django模板开发的用户能够快速上手Grantlee。这些功能包括：

常用标签

• if/else条件判断
• for循环
• block和extends模板继承
• include包含其他模板
• with创建局部变量
• autoescape自动转义控制

常用过滤器

• date日期格式化
• default默认值
• length获取长度
• lower/upper大小写转换
• slice切片
• join连接列表
• safe标记安全内容

未移植功能

由于技术限制和时间原因，Grantlee尚未移植以下Django功能：

• url标签（Grantlee没有视图系统）
• ssi标签（出于安全考虑）
• 部分过滤器如dictsort、filesizeformat、pluralize等

Grantlee特有功能

除了Django移植的功能外，Grantlee还提供了一些特有的标签，增强了模板的功能性。

media_finder标签

media_finder是Grantlee中一个非常实用的标签，用于获取外部媒体资源的完整URL。

基本用法

<img src="{% media_finder "someimage.png" %}" />

工作原理

该标签通过Engine::mediaUri方法查询TemplateLoaders获取URL，最终通过AbstractTemplateLoader::getMediaUri接口返回结果。

配置选项

1. URL类型设置：通过Context::setUrlType方法配置生成绝对URL还是相对URL
2. 相对路径设置：使用Context::setRelativeMediaPath方法指定相对基础路径

使用场景示例

假设我们有一个模板/home/user/myoutput.html，需要引用图片someimage.png：

1. 设置相对路径为"myoutput_media/"
2. media_finder会生成路径myoutput_media/someimage.png
3. 开发者需要确保图片实际存在于/home/user/myoutput_media/目录

这种设计使得输出文件和引用的媒体资源可以作为一个整体轻松移植。

range标签

range标签提供了类似Python中range函数的功能，用于生成数字序列。

基本用法

1. 从0到5的序列：

<ul>
{% range 5 as num %}
  <li>{{ num }}
{% endrange %}
</ul>

2. 从5到10的序列：

<ul>
{% range 5 10 as num %}
  <li>{{ num }}
{% endrange %}
</ul>

3. 带步长的序列（5到50，步长5）：

<ul>
{% range 5 50 5 as num %}
  <li>{{ num }}
{% endrange %}
</ul>

无参数用法

{% range rating %}
  <img src="{% media_finder "star.png" %}" />
{% endrange %}

这种用法会根据rating变量的值循环显示星形图标，非常适合评分系统的实现。

总结

Grantlee通过移植Django的模板功能和添加特有标签，提供了一个功能强大且灵活的模板引擎解决方案。media_finder标签简化了媒体资源管理，range标签增强了循环控制能力，这些特性使得Grantlee在C++项目中处理模板渲染变得更加高效和便捷。