屏幕内局部叠层状态。
使用 OverlayRequest? 表达对话框与底部弹层，并通过 ScreenOverlayHost 或 AnimatedScreenOverlayHost 渲染出来。
单一叠层槽位
将叠层建模为 OverlayRequest?，清空即可关闭。
支持对话框与底部弹层
使用 DialogRequest 与 BottomSheetRequest，并可附带可选载荷。
控制返回顺序
通过返回作用域组件，先关闭叠层，再返回页面。
叠层宿主模式
将叠层保留在状态中，并通过 overlayBuilder 构建叠层 UI。
叠层状态规则
动效叠层宿主
return AnimatedScreenOverlayHost(
overlay: _overlay,
onDismiss: _dismissOverlay,
overlayBuilder: (context, req, dismiss) => switch (req) {
DialogRequest(key: 'hello') => AlertDialog(
title: const Text('Hello'),
actions: [TextButton(onPressed: dismiss, child: const Text('Close'))],
),
_ => null,
},
child: DeclarativePagesNavigator(
pages: _pages,
buildPage: _buildPage,
onPopTop: _popTop,
canPopTop: () => _overlay == null,
),
);
重要
当叠层可见时， 使用 canPopTop 阻止返回手势 以避免 iOS 上的返回手势不一致。