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 응답을 전송하려면 스타일시트를 문자열로 직렬화하고 이를 CSS 콘텐츠 타입과 함께 클라이언트로 전송하는 respondCss 메서드를 추가하여 ApplicationCall을 확장해야 합니다:
kotlin
suspend inline fun ApplicationCall.respondCss(builder: CssBuilder.() -> Unit) {
this.respondText(CssBuilder().apply(builder).toString(), ContentType.Text.CSS)
}그런 다음 필요한 라우트 내부에서 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에서 확인할 수 있습니다.
