一、概念
在 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()
}
}
}