Skip to content
Server Plugin

Webjars

所需依赖项: io.ktor:ktor-server-webjars

代码示例: webjars

原生服务器
Ktor 支持 Kotlin/Native,无需额外的运行时或虚拟机即可运行服务器。
支持: ✖️

Webjars 插件支持提供由 WebJars 提供的客户端库。它允许您将 JavaScript 和 CSS 库等资源作为 fat JAR 的一部分进行打包。

添加依赖项

要启用 Webjars,您需要在构建脚本中包含以下构件:

  • 添加 ktor-server-webjars 依赖项:

    Kotlin
    Groovy
    XML
  • 添加所需客户端库的依赖项。下面的示例展示了如何添加一个 Bootstrap 构件:

    Kotlin
    Groovy
    XML

    您可以将 $bootstrap_version 替换为 bootstrap 构件的所需版本,例如 5.2.3

安装 Webjars

要将 Webjars 插件安装到应用程序, 请将其传递给指定

模块
模块允许您通过分组路由来组织应用程序。
中的 install 函数。 下面的代码片段展示了如何安装 Webjars ……

  • ... 在 embeddedServer 函数调用内部。
  • ... 在显式定义的 module 中,它是 Application 类的扩展函数。
kotlin
kotlin

配置 Webjars

默认情况下,Webjars/webjars 路径上提供 WebJars 资源。下面的示例展示了如何更改此设置并在 /assets 路径上提供任何 WebJars 资源:

kotlin
import io.ktor.server.application.*
import io.ktor.server.webjars.*

fun Application.module() {
    install(Webjars) {
        path = "assets"
    }
}

例如,如果您安装了 org.webjars:bootstrap 依赖项,您可以如下添加 bootstrap.css

html
<head>
    <link rel="stylesheet" href="/assets/bootstrap/bootstrap.css">
</head>

请注意,Webjars 允许您更改依赖项的版本,而无需更改用于加载它们的路径。

您可以在这里找到完整的示例:webjars