/* * Copyright (c) 2017-present Robert Jaros * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. */ package pl.treksoft.kvision.data import com.github.snabbdom.VNode import com.lightningkite.kotlin.observable.list.ObservableList import pl.treksoft.kvision.core.Component import pl.treksoft.kvision.core.Container import pl.treksoft.kvision.core.Widget import pl.treksoft.kvision.panel.VPanel /** * A container class with support for observable data model. * * @constructor Creates DataContainer bound to given data model. * @param M data model type * @param C visual component type * @param model data model of type *ObservableList* * @param factory a function which creates component C from data model at given index * @param filter a filtering function * @param mapping a mapping function * @param container internal container (defaults to [VPanel]) * @param init an initializer extension function */ class DataContainer( private val model: ObservableList, private val factory: (Int, M) -> C, private val filter: ((Int, M) -> Boolean)? = null, private val mapping: ((List) -> List)? = null, private val container: Container = VPanel(), init: (DataContainer.() -> Unit)? = null ) : Widget(setOf()), Container, DataUpdatable { override var visible get() = container.visible set(value) { container.visible = value } internal var onUpdateHandler: (() -> Unit)? = null init { container.parent = this model.onUpdate += { _ -> update() } update() @Suppress("LeakingThis") init?.invoke(this) } override fun add(child: Component): Container { this.container.add(child) return this } override fun addAll(children: List): Container { this.container.addAll(children) return this } override fun remove(child: Component): Container { this.container.remove(child) return this } override fun removeAll(): Container { this.container.removeAll() return this } override fun getChildren(): List { return this.container.getChildren() } override fun renderVNode(): VNode { return this.container.renderVNode() } /** * Updates view from the current data model state. */ override fun update() { model.forEach { if (it is DataComponent) it.container = this } singleRender { container.removeAll() val mapped = mapping?.invoke(model) ?: model val indexed = mapped.mapIndexed { index, m -> index to m } val children = if (filter != null) { indexed.filter { p -> filter.invoke(p.first, p.second) } } else { indexed }.map { p -> factory(p.first, p.second) } container.addAll(children) } onUpdateHandler?.invoke() } /** * Sets a notification handler called after every update. * @param handler notification handler * @return current container */ fun onUpdate(handler: () -> Unit): DataContainer { onUpdateHandler = handler return this } /** * Clears notification handler. * @return current container */ fun clearOnUpdate(): DataContainer { onUpdateHandler = null return this } companion object { /** * DSL builder extension function. * * It takes the same parameters as the constructor of the built component. */ fun Container.dataContainer( model: ObservableList, factory: (Int, M) -> C, filter: ((Int, M) -> Boolean)? = null, mapping: ((List) -> List)? = null, container: Container = VPanel(), init: (DataContainer.() -> Unit)? = null ): DataContainer { val dataContainer = DataContainer(model, factory, filter, mapping, container, init) this.add(dataContainer) return dataContainer } } }