Compose - 自定义作用域限制函数

一、概念

        在 Compose 中对于作用域的应用特别多。比如 weight 修饰符只能用在 RowScope 或者 ColumnScope 作用域中，item 组件只能用在 LazyListScope 作用域中。

        标准库中的作用域函数如 apply()、let() 会以不同方式持有和返回上下文对象，调用它们时 Lambda 参数将处在特定的作用域。

        Compose 通过带接收者的 Lambda（高阶函数+隐式receiver）实现作用域向外的限制（只能在某个函数的大括号内部访问特定的属性和方法），通过 @DslMaker 实现向内切断作用域传递（属性和方法在内部有意义，在内部的内部无意义，防止API污染）。

二、自定义

2.1 编写作为作用域的接口

定义功能（成员方法和属性）。

interface GuideScreenScope {
    val isShownOnce: Boolean
    @Composable fun ShowGuide()
    @Composable fun DrawLine()
}

2.2 实现接口

具体实现。

class GuideScreenScopeImpl : GuideScreenScope {
    override val isShownOnce: Boolean
        get() = TODO("编写判断逻辑")
    @Composable
    override fun ShowGuide() { TODO("编写界面") }
}

2.3 暴露的方法

将 Lambda 参数的接收者设为接口，这样就限制在了该作用域内，该 Lambda 中就可以调用作用域内的成员函数和属性。

@Composable
fun GuideScreen(content: @Composable GuideScreenScope.() -> Unit) {
    //TODO:实现其它逻辑，例如先显示一段动画
    GuideScreenScopeImpl().content()
}

3.4 外部使用

@Composable
fun Demo() {
    GuideScreen {
        if (!isShownOnce) {
            ShowGuide()
        }
    }
}