Skip to content

CSS DSL ​

必要な依存関係: io.ktor:ktor-server-html-builder, org.jetbrains.kotlin-wrappers:kotlin-css

コード例: css-dsl

CSS DSL は HTML DSL を拡張し、kotlin-css ラッパーを使用して Kotlin でスタイルシートを作成できるようにします。

静的コンテンツとしてスタイルシートを配信する方法については、静的コンテンツの配信 を参照してください。

依存関係の追加 ​

CSS DSL は インストール の必要はありませんが、ビルドスクリプトに以下のアーティファクトを含める必要があります:

  1. HTML DSL 用の ktor-server-html-builder アーティファクト:

    kotlin
    implementation(ktorLibs.server.htmlBuilder)
    上記のスニペットは、Ktor の依存関係を指定するために Ktor バージョンカタログ を使用しています。
    groovy
    implementation ktorLibs.server.htmlBuilder
    上記のスニペットは、Ktor の依存関係を指定するために Ktor バージョンカタログ を使用しています。
    xml
    <dependency>
        <groupId>io.ktor</groupId>
        <artifactId>ktor-server-html-builder-jvm</artifactId>
        <version>${ktor_version}</version>
    </dependency>
  2. CSS を構築するための kotlin-css-jvm アーティファクト:

    kotlin
    implementation("org.jetbrains.kotlin-wrappers:kotlin-css:$kotlin_css_version")
    groovy
    implementation "org.jetbrains.kotlin-wrappers:kotlin-css:$kotlin_css_version"
    xml
    <dependency>
        <groupId>org.jetbrains.kotlin-wrappers</groupId>
        <artifactId>kotlin-css</artifactId>
        <version>${kotlin_css_version}</version>
    </dependency>

    $kotlin_css_version は、必要な kotlin-css アーティファクトのバージョン(例: 2026.10.5)に置き換えることができます。

CSS の配信 ​

CSS レスポンスを送信するには、ApplicationCall を拡張して respondCss メソッドを追加し、スタイルシートを文字列にシリアライズして CSS コンテンツタイプでクライアントに送信できるようにします:

kotlin
suspend inline fun ApplicationCall.respondCss(builder: CssBuilder.() -> Unit) {
    this.respondText(CssBuilder().apply(builder).toString(), ContentType.Text.CSS)
}

その後、必要なルート (route) 内で CSS を提供できます:

kotlin
get("/styles.css") {
    call.respondCss {
        body {
            backgroundColor = Color.darkBlue
            margin = Margin(0.px)
        }
        rule("h1.page-title") {
            color = Color.white
        }
    }
}

最後に、HTML DSL で作成した HTML ドキュメントに対して、指定した CSS を使用できます:

kotlin
get("/html-dsl") {
    call.respondHtml {
        head {
            link(rel = "stylesheet", href = "/styles.css", type = "text/css")
        }
        body {
            h1(classes = "page-title") {
                +"Hello from Ktor!"
            }
        }
    }
}

完全なサンプルはこちらで確認できます: css-dsl。