kslides-core/com.kslides.config/PlaygroundConfig

PlaygroundConfig

Kotlin Playground embedding options. The top section mirrors the attributes defined by the Kotlin Playground library itself; the lower section controls the iframe wrapper kslides generates around it.

Three separate CSS surfaces, differing by scope:

style — inline CSS on the <iframe> element itself, in the surrounding slide's document. Sizes and frames the box; it cannot reach the code inside.
fontSize / lineHeight — typed properties rendered by cssText into the iframe's head.
css — raw rules, also in the iframe's head, emitted after cssText.

A Playground styling option earns a typed property when it needs a Playground-internal selector or a specificity workaround a deck author cannot reasonably discover (see cssText); anything reachable by an obvious selector stays in css.

Constructors

PlaygroundConfig

constructor()

Types

Companion

object Companion

Properties

args

var args: String

Playground args attribute — command-line arguments passed when the code runs.

autoIndent

var autoIndent: Boolean

Automatically re-indent the code as the user types.

css

val css: CssValue

CSS injected into the generated Playground iframe's <head>, after the rules generated for fontSize — so a rule declared here wins over them at equal specificity. Reach for fontSize first; use this for Playground internals it does not cover.

dataAutocomplete

var dataAutocomplete: Boolean

Enable autocomplete in the Playground editor.

dataCrosslink

var dataCrosslink: Crosslink

Toggle for Playground's "open in IDE" crosslink button.

dataHighlightOnly

var dataHighlightOnly: Boolean

When true, disables the Run button and just syntax-highlights the code.

dataJsLibs

var dataJsLibs: String

Space-separated list of JS library URLs loaded before JS-target code runs.

dataMinCompilerVersion

var dataMinCompilerVersion: String

Minimum Kotlin compiler version that must be available on the Playground backend.

dataOutputHeight

var dataOutputHeight: Int

Maximum output-pane height in pixels.

dataScrollbarStyle

var dataScrollbarStyle: String

CodeMirror scrollbarStyle (e.g. "simple", "null").

dataShorterHeight

var dataShorterHeight: Int

Shorter editor height variant (pixels).

dataTargetPlatform

var dataTargetPlatform: TargetPlatform

Execution target for the embedded code (e.g. JVM, JS, JUnit).

foldedButton

var foldedButton: Boolean

When true, collapses the editor behind a "Show code" button.

fontSize

var fontSize: String

Font size of the code in the Playground editor and its run-output pane — any CSS length. Blank keeps Playground's own default.

from

var from: Int

First line to display from the source file (1-based).

height

var height: String

iframe height attribute. Default "250px".

highlightOnFly

var highlightOnFly: Boolean

Re-highlight code while it is being edited.

indent

var indent: Int

Editor indentation width in spaces.

lineHeight

var lineHeight: String

line-height for the Playground editor and run-output pane — a unitless ratio ("1.4") or a CSS length. Blank keeps CodeMirror's own ratio, which already scales with fontSize; set this only to tighten or loosen the spacing itself.

lines

var lines: Boolean

Show line numbers.

matchBrackets

var matchBrackets: Boolean

Highlight matching brackets in the editor.

mode

var mode: PlaygroundMode

Language/syntax mode the editor operates in.

staticContent

var staticContent: Boolean

When true, the generated Playground HTML is cached for the lifetime of the com.kslides.KSlides instance. Set to false only if the Playground content depends on runtime state that changes between requests.

style

var style: String

Inline CSS applied to the iframe. Useful for adding borders while tuning layout.

theme

var theme: PlaygroundTheme

Editor color theme.

title

var title: String

Accessible title text for screen readers.

var to: Int

Last line to display from the source file (inclusive).

width

var width: String

iframe width attribute. Default "100%".

Functions

css

fun css(block: CssBuilder.() -> Unit)

Append CSS (via the Kotlin CSS DSL) to the Playground iframe's stylesheet.

merge

open fun merge(other: AbstractConfig)

Merge other into this config in place: every entry from other's two maps is copied into this config's maps, with later puts overwriting earlier keys. This is how the global → presentation → slide cascade resolves (parent merged first, then child).

revealjsOption

open fun revealjsOption(key: String, value: Any)

Set a raw reveal.js config option by key for options kslides does not expose as a typed property (e.g. the menu plugin's themes array). The value is emitted verbatim into the Reveal.initialize({...}) call and participates in the config cascade like any other option. Prefer the typed properties where they exist.