Skip to content
Server Plugin

Webjars

必要的相依性io.ktor:ktor-server-webjars

程式碼範例 webjars

Native 伺服器
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