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 は インストール の必要はありませんが、ビルドスクリプトに以下のアーティファクトを含める必要があります:
HTML DSL 用の
ktor-server-html-builderアーティファクト:kotlinimplementation(ktorLibs.server.htmlBuilder)上記のスニペットは、Ktor の依存関係を指定するために Ktor バージョンカタログ を使用しています。groovyimplementation ktorLibs.server.htmlBuilder上記のスニペットは、Ktor の依存関係を指定するために Ktor バージョンカタログ を使用しています。xml<dependency> <groupId>io.ktor</groupId> <artifactId>ktor-server-html-builder-jvm</artifactId> <version>${ktor_version}</version> </dependency>CSS を構築するための
kotlin-css-jvmアーティファクト:kotlinimplementation("org.jetbrains.kotlin-wrappers:kotlin-css:$kotlin_css_version")groovyimplementation "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。
