Server Plugin
Webjars
必要依賴: io.ktor:ktor-server-webjars
程式碼範例: webjars
原生伺服器支援: ✖️ Ktor 支援 Kotlin/Native,可讓您在無需額外執行時或虛擬機器的情況下執行伺服器。
Webjars 插件可啟用提供由 WebJars 提供的用戶端函式庫。它允許您將 JavaScript 和 CSS 函式庫等資產打包為您的 獨立 JAR 檔 的一部分。
新增依賴
若要啟用 Webjars,您需要將以下構件包含在建置腳本中:
新增
ktor-server-webjars
依賴:KotlinGroovyXML新增所需用戶端函式庫的依賴。下方範例展示如何新增 Bootstrap 構件 (artifact):
KotlinGroovyXML您可以將
$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。