Webjars
必須依存関係: io.ktor:ktor-server-webjars
コード例: webjars
Webjarsプラグインは、WebJarsによって提供されるクライアントサイドライブラリの提供を可能にします。これにより、JavaScriptやCSSライブラリなどのアセットをfat JARの一部としてパッケージ化できます。
依存関係を追加する
Webjarsを有効にするには、ビルドスクリプトに以下のアーティファクトを含める必要があります:
ktor-server-webjars
依存関係を追加します:KotlinGroovyXML必要なクライアントサイドライブラリの依存関係を追加します。以下の例は、Bootstrapアーティファクトを追加する方法を示しています:
KotlinGroovyXML$bootstrap_version
を、例えば5.2.3
のようなbootstrap
アーティファクトの必要なバージョンに置き換えることができます。
Webjarsをインストールする
アプリケーションにWebjars
プラグインをインストールするには、 指定された
install
関数に渡します。 以下のコードスニペットは、Webjars
をインストールする方法を示しています... - ...
embeddedServer
関数呼び出し内で。 - ...
Application
クラスの拡張関数である、明示的に定義されたmodule
内で。
Webjarsを設定する
デフォルトでは、Webjars
は/webjars
パスでWebJarsアセットを提供します。以下の例は、これを変更し、/assets
パスで任意のWebJarsアセットを提供する方法を示しています:
import io.ktor.server.application.*
import io.ktor.server.webjars.*
fun Application.module() {
install(Webjars) {
path = "assets"
}
}
例えば、org.webjars:bootstrap
依存関係をインストールしている場合、bootstrap.css
を次のように追加できます:
<head>
<link rel="stylesheet" href="/assets/bootstrap/bootstrap.css">
</head>
注意点として、Webjars
は、依存関係のバージョンを、それらをロードするために使用されるパスを変更せずに変更することを可能にします。
完全な例はwebjarsで見つけることができます。