swift-html-vapor

用于 Vapor 的插件，它使用 swift-html 提供类型安全、可转换的 HTML 视图。

动机

在 Vapor Web 应用中渲染 HTML 最流行的选择是使用 Leaf 模板语言，但它会将您的应用程序暴露于运行时错误和无效的 HTML。我们的插件通过将 HTML 直接嵌入到 Swift 强大的类型系统中，可以在编译时防止这些运行时问题。它使用 swift-html DSL，使用纯 Swift 数据结构来构建 HTML 文档。

用法

要使用该插件，您只需从路由器回调函数返回一个 Node 值即可

import HtmlVaporSupport
import Vapor

var env = try Environment.detect()
let app = Application(env)
defer { app.shutdown() }

app.get { _ in
  Node.h1("Hello, type-safe HTML on Vapor!")
}

try app.run()

亲自体验一下

我们在本仓库中包含了一个示例 Vapor 应用程序，以展示它的用法。要立即运行该应用程序，只需执行

swift run HtmlVaporSupportExample
在浏览器中打开 https://:8080

该页面的 HTML 是使用 swift-html 构建和渲染的！

如果您想在 Xcode 中运行该应用程序，以便可以试用 HTML，请尝试以下操作

git clone https://github.com/pointfreeco/swift-html-vapor
cd swift-html-vapor
make xcodeproj
选择 HtmlVaporSupportExample 目标
构建并运行 cmd+R
在浏览器中打开 https://:8080

安装

如果您想在使用了 SwiftPM 的项目中使用 swift-html-vapor，只需将 dependencies 子句添加到您的 Package.swift 即可

dependencies: [
  .package(url: "https://github.com/pointfreeco/swift-html-vapor", from: "0.4.0")
]

许可证

所有模块均在 MIT 许可证下发布。有关详细信息，请参见 LICENSE。