使用场景装饰器修改场景

借助场景装饰器，您可以修改应用场景策略计算出的场景。实际上，它们用于构建 NavDisplay 显示的内容的第二阶段。

此方法可让您将特定功能（例如显示常见界面组件）封装到各个场景装饰器中。

例如，假设某个效率提升应用有三个顶级路线：电子邮件收件箱、私信收件箱和日历视图。此类应用可以使用两个场景装饰器，一个用于添加顶部应用栏，以显示当前顶级路由的信息和控制器；另一个用于添加持久性导航栏或导航轨道，以在各个路由之间导航。

创建场景装饰器策略

场景装饰器遵循与场景策略类似的模式。如需定义场景装饰器，请实现 SceneDecoratorStrategy 接口。此接口有一个方法 decorateScene，该方法类似于 SceneStrategy 接口的 calculateScene 方法。decorateScene 确定是否可以装饰场景：

如果场景装饰器策略不应装饰输入场景，则会原封不动地返回输入场景。
如果它应该装饰输入场景，则返回新的 Scene。一般来说，返回的场景会将输入场景作为参数，并在其自身的 content 方法中调用输入场景的 content 方法。

为了确定是否以及如何装饰输入场景，场景装饰器策略可以考虑输入 Scene 的元数据以及该场景中包含的条目的元数据。

class MySceneDecoratorStrategy<T : Any> : SceneDecoratorStrategy<T> {


    override fun SceneDecoratorStrategyScope<T>.decorateScene(scene: Scene<T>): Scene<T> {
        // `shouldDecorate` determines if the scene should be decorated based on scene.metadata,
        // scene.entries.metadata, or any other relevant state.
        return if (shouldDecorate(scene)) {
            MyDecoratingScene(scene)
        } else {
            scene
        }
    }

}

class MyDecoratingScene<T : Any>(scene: Scene<T>) : Scene<T> {

    // ...

    override val content = @Composable {
        scene.content()
    }
}SceneDecoratorSnippets.kt

使用场景装饰器策略

如需使用场景装饰器策略，请使用 sceneDecoratorStrategies 参数将其提供给 NavDisplay。在装饰场景时，NavDisplay 会依次调用每种策略的 decorateScene 方法，并将每次调用的输出作为下一次调用的输入。

NavDisplay(
    // ...
    sceneDecoratorStrategies = listOf(firstSceneDecoratorStrategy, secondSceneDecoratorStrategy)
)SceneDecoratorSnippets.kt

场景装饰器的常见模式

实现场景装饰器时，需要注意以下一些常见模式：

复制属性

在许多情况下，通过装饰场景返回的场景应包含相同的条目，并具有与所装饰的场景相同的先前条目。此外，它可能应继承（或修改）所装饰场景的元数据，而不是使用默认行为。以下代码演示了如何执行此操作：

class CopyingScene<T : Any>(scene: Scene<T>) : Scene<T> {
    override val entries = scene.entries
    override val previousEntries = scene.previousEntries
    override val metadata = scene.metadata

    // ...
}SceneDecoratorSnippets.kt

保留动画

如在目的地之间添加动画效果中所述，当从当前场景的类及其 key 属性派生的键发生变化时，NavDisplay 会自动为场景之间的过渡添加动画效果。

向应用引入场景装饰器时，即使在场景计算期间返回的场景类发生变化，场景装饰后返回的场景类也可以保持不变。如果出现这种情况，并且装饰场景直接复制其装饰的场景的 key，那么内置动画将不再发生，因为派生密钥不会更改。

为了保持内置动画支持，装饰场景应使用从 calculateScene 返回的场景的类和 key 派生的键。

class DerivedKeyScene<T : Any>(scene: Scene<T>) : Scene<T> {
    override val key = scene::class to scene.key

    // ...
}SceneDecoratorSnippets.kt