You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Igor Demin 7bd0b3d1a5
Fix examples, templates (#2359)
2 years ago
..
.run examples README and .run configurations (#2355) 2 years ago
gradle/wrapper update gradle wrapper 7.5.1 (#2352) 2 years ago
screenshots Fix examples, templates (#2359) 2 years ago
src/jsMain web: add example for dom-based-composables usage in plain JS (#1677) 3 years ago
webpack.config.d web: add missing webpack.config.d in web-compose-in-js example (#1683) 3 years ago
.gitignore remove kotlin-js-store in web-compose-in-js (#1707) 3 years ago
README.MD Fix examples, templates (#2359) 2 years ago
build.gradle.kts Fix examples, templates (#2359) 2 years ago
gradle.properties Fix examples, templates (#2359) 2 years ago
gradlew web: add example for dom-based-composables usage in plain JS (#1677) 3 years ago
gradlew.bat web: add example for dom-based-composables usage in plain JS (#1677) 3 years ago
settings.gradle.kts Fix examples, templates (#2359) 2 years ago

README.MD

How to use HTML based @Composable functions in JS?

Useful links:

  1. @Composable functions can't be invoked from JS directly (because every @Composable function has implicit parameters added by compiler plugin)
  2. We can wrap @Composable functions into some usual function (with @JsExport) which can be invoked in JS as is.
  3. Every call to a "wrapping" function will create a composition (part of DOM controlled by Compose runtime)
  4. It's important to dispose a composition when it's not needed.
  5. The composition's state can be controlled by creating an arbitrary Controller class, which implements and exposes necessary functions for state updates.

Simplified example (see full example in src/jsMain):

// Composables.kt

@JsExport
abstract class ComposeCounterAppController {
    abstract fun setCount(newCount: Int)
    abstract fun dispose()
}

@JsExport
fun ComposeCounterApp(rootId: String, onCountChange: (Int) -> Unit = {}): ComposeCounterAppController {
    var count: Int by mutableStateOf(0)

    val composition = renderComposable(rootElementId = rootId) {
        // Counter is a @Composable function
        // see full example in src/jsMain
        Counter(count) {
            count = it
            onCountChange(count)
        }
    }

    return object : ComposeCounterAppController() {
        override fun setCount(newCount: Int) {
            count = newCount
        }

        override fun dispose() {
            composition.dispose()
        }
    }
}

Then in JS we can use ComposeCounterApp function:

// see src/jsMain/resources/use_compose.js file for a full example

counterController = MyComposables.ComposeCounterApp('counterByCompose', (newCount) => {
    console.log(`Counter was updated. New value = ${newCount}`);
});

The module name was overridden to make it convenient for usage in JS:

// webpack.config.d/configModuleName.js

config.output = config.output || {};
config.output.library = "MyComposables";

Running Web browser application

  • To run, launch command: ./gradlew :jsBrowserDevelopmentRun
  • Or choose browser configuration in IDE and run it.
    browser-run-configuration.png

Building and using the output

./gradlew jsBrowserProductionWebpack

This will produce the output in build/distributions. Then we can use exported functions from web-compose-in-js.js (the filename is defined by the project/module name).

<script src="web-compose-in-js.js"></script>
<script src="use_compose.js"></script>