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を、例えば5.2.3のようなbootstrapアーティファクトの必要なバージョンに置き換えることができます。

Webjarsをインストールする

アプリケーションにWebjarsプラグインをインストールするには、 指定された

モジュール
モジュールは、ルートをグループ化することでアプリケーションを構造化できます。
内のinstall関数に渡します。 以下のコードスニペットは、Webjarsをインストールする方法を示しています...

  • ... embeddedServer関数呼び出し内で。
  • ... Applicationクラスの拡張関数である、明示的に定義されたmodule内で。
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で見つけることができます。