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