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 関数の呼び出し内。
  • ... Application クラスの拡張関数である、明示的に定義された module 内。
kotlin
kotlin

Webjars の設定

デフォルトでは、Webjars は WebJars のアセットを /webjars パスで配信します。以下の例は、これを変更して WebJars のアセットを /assets パスで配信する方法を示しています。

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