Skip to content
Server Plugin

Webjars

必要依賴: io.ktor:ktor-server-webjars

程式碼範例: webjars

原生伺服器
Ktor 支援 Kotlin/Native,可讓您在無需額外執行時或虛擬機器的情況下執行伺服器。
支援: ✖️

Webjars 插件可啟用提供由 WebJars 提供的用戶端函式庫。它允許您將 JavaScript 和 CSS 函式庫等資產打包為您的 獨立 JAR 檔 的一部分。

新增依賴

若要啟用 Webjars,您需要將以下構件包含在建置腳本中:

  • 新增 ktor-server-webjars 依賴:

    Kotlin
    Groovy
    XML
  • 新增所需用戶端函式庫的依賴。下方範例展示如何新增 Bootstrap 構件 (artifact):

    Kotlin
    Groovy
    XML

    您可以將 $bootstrap_version 替換為 bootstrap 構件 (artifact) 的所需版本,例如 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