Stencil模板语言：Swift开发者的轻量级模板引擎指南-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00999/article/details/148864190

Stencil模板语言：Swift开发者的轻量级模板引擎指南

什么是Stencil模板语言

Stencil是一个专为Swift设计的简单而强大的模板语言，其语法灵感来源于Django和Mustache等知名模板系统。如果你之前接触过这些模板语言，会发现Stencil的学习曲线非常平缓。Stencil的核心目标是帮助开发者将业务逻辑与界面展示分离，实现更清晰的代码结构。

基础语法示例

让我们通过一个简单的例子来了解Stencil的基本语法：

<!-- 显示文章总数 -->
There are {{ articles.count }} articles.

<!-- 文章列表循环 -->
<ul>
  {% for article in articles %}
    <li>{{ article.title }} by {{ article.author }}</li>
  {% endfor %}
</ul>

这段模板展示了Stencil的两个核心功能：

变量插值：使用双大括号{{ }}包裹变量
控制结构：使用{% %}标签实现逻辑控制

Swift集成示例

在Swift项目中使用Stencil非常简单：

import Stencil

// 定义数据结构
struct Article {
  let title: String
  let author: String
}

// 准备模板上下文数据
let context = [
  "articles": [
    Article(title: "从OCUnit迁移到XCTest", author: "Kyle Fuller"),
    Article(title: "ARC内存管理", author: "Kyle Fuller"),
  ]
]

// 创建模板环境并渲染
let environment = Environment(loader: FileSystemLoader(paths: ["templates/"]))
let rendered = try environment.renderTemplate(name: "articles.html", context: context)

print(rendered)

Stencil核心特性

1. 变量输出

Stencil支持直接输出变量值，也支持点语法访问嵌套属性：

{{ user.name }}  <!-- 输出用户名称 -->
{{ article.created_at|date:"yyyy-MM-dd" }}  <!-- 使用过滤器格式化日期 -->

2. 控制结构

包括条件判断和循环等常见控制结构：

{% if users.count > 0 %}
  <p>有{{ users.count }}位用户</p>
{% else %}
  <p>暂无用户</p>
{% endif %}

3. 模板继承

支持类似Django的模板继承机制，可以实现布局复用：

<!-- base.html -->
<html>
<head><title>{% block title %}默认标题{% endblock %}</title></head>
<body>
  {% block content %}{% endblock %}
</body>
</html>

<!-- child.html -->
{% extends "base.html" %}

{% block title %}我的页面{% endblock %}

{% block content %}
  <p>这里是页面内容</p>
{% endblock %}

4. 自定义标签和过滤器

开发者可以扩展Stencil的功能，添加自定义标签和过滤器：

// 注册自定义过滤器
environment.filters["uppercase"] = { value in 
    guard let string = value as? String else { return value }
    return string.uppercased()
}

// 模板中使用
{{ "hello"|uppercase }}  <!-- 输出 "HELLO" -->