Swift Web 开发之 Vapor - 模版 Leaf（三）
|
模版引擎，对现在的 Web 开发极为重要，几乎所有主流 Web 框架都会支持一种或多种模版引擎，模版引擎可以分离用户界面和业务逻辑，工作原理主要是一种翻译，后端对特定的标记、语法、变量等渲染后再输送给浏览器，如今模版引擎已经非常强大，在相关领域可以帮助开发者节约很多时间精力，比如缓存、设计分层、插件化。不同的模版引擎千变万化，各种语言也是层出不穷，比如 PHP 模版引擎中的老大哥 Smarty，Python 的 Jinja2，也是 Flask 中内置的模版引擎，如今前端也有新生模版引擎，依赖前端的性能提升，像后端一样处理模版语言渲染数据。 Leaf 作为 Vapor 官方提供的组件之一原生集成在 Vapor 中，Leaf 模版文件以 渲染我们可以在路由中进行模版的渲染，同时附带给模版传参数，参数以 Dict 的形式放在第二个位置，然后在 drop.get { req in return try drop.view.make("index.leaf",['greeting': "Hello world!"]) }
标记 (#)Leaf 使用 我们可以用 #(<a>hello</a>)
如果想输出原始 HTML 怎么办呢？我们可以用 #raw() { <a>hello</a> }
变量#(variable)
比较#equal(leaf,leaf)
判断下面这段代码逻辑就是 #if(entering) {
Hello,there!
} ##if(leaving) {
Goodbye!
} ##else() {
I've been here the whole time.
}
循环#loop(users,"user") {
Hello,#(user.name)! </br >
}
基本循环用
模块化我们构建一些多页面 Web 程序，常常会有每个页面或者一种页面部分相似的内容，比如网站的头部、脚部，头部一般用来放导航栏，脚部放一些版权声明、三方链接等等，那么在整个网站任何页面中这两部分的内容基本都是一致的，那么我们可以把这两部分的内容抽出一个单独的 Leaf 提供了四个方法来引入/包含其他模版：
举个栗子： /// base.leaf
<html>#import("html-content")</html>
/// index.leaf
#extend("base")
#export("html-content") {
Hello
}
渲染 然后是 /// html-content.leaf
Hello
/// index.leaf
<html>#embed("html-content")</html>
上面代码渲染 自定义标签有时候官方提供的标签功能不够我们使用，当然 Leaf 给我们留出了自定义的空间，我们可以声明自己的标签然后在 我们可以通过声明一个类来自定义一种标签，借用一下官方的例子，定义在 Leaf/Tag/Models/Index.swift：，该代码定义了一个方法用来获取数组中指定下标的一个元素： class Index: BasicTag {
let name = "index1"
func run(arguments: [Argument]) throws -> Node? {
guard
arguments.count == 2,let array = arguments[0].value?.nodeArray,let index = arguments[1].value?.int,index < array.count
else { return nil }
return array[index]
}
}
然后再向 if let leaf = drop.view as? LeafRenderer {
leaf.stem.register(Index())
}
有了自定义标签的功能，我们可以丰富很多自己的功能逻辑，甚至定义一个快速解析 Markdown 的标签，用起来会相当方便。 语法高亮根据 Vapor 官方提示，VSCode 和 Atom 有对应的语法高亮插件，如有需要可以试试。
结语
这是 [Swift Web 开发之 Vapor] 系列的第三篇，说了说 Vapor 中自带的 Leaf 模版引擎，按照笔者目前的使用情况来看其实 Leaf 还不太成熟，虽然还有太多需要优化改进的地方，不过我相信之后一定会越来越好的。所以不要害怕，赶紧来写 Swift Server Side 吧！ 之前开的坑在写一个博客程序 NSPress，如果大家有兴趣欢迎讨论。 （编辑：李大同） 【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容! |