跳到主要内容
版本:0.78

模态框

Modal 组件是一种在封闭视图之上呈现内容的基本方式。

示例


参考

属性

View 属性

继承 View 属性


animated

已弃用。 请改用 animationType 属性。


animationType

animationType 属性控制模态框的动画方式。

可能的值:

  • slide 从底部滑入
  • fade 淡入视图
  • none 无动画出现
类型默认值
enum('none', 'slide', 'fade')none

backdropColor

模态框的 backdropColor(或模态框容器的背景颜色。)如果未提供且 transparentfalse,则默认为 white。如果 transparenttrue,则忽略此属性。

类型默认值
颜色white

hardwareAccelerated
安卓

hardwareAccelerated 属性控制是否强制底层窗口进行硬件加速。

类型默认值
布尔值false

navigationBarTranslucent 属性确定您的模态框是否应位于系统导航栏下方。但是,也需要将 statusBarTranslucent 设置为 true 才能使导航栏半透明。

类型默认值
布尔值false

onDismiss
iOS

onDismiss 属性允许传递一个函数,该函数将在模态框被解散后调用。

类型
函数

onOrientationChange
iOS

onOrientationChange 回调在模态框显示时方向发生变化时调用。提供的方向仅为 'portrait' 或 'landscape'。无论当前方向如何,此回调也会在初始渲染时调用。

类型
函数

onRequestClose

当用户在 Android 上按下硬件返回按钮,或在 Apple TV 上按下菜单按钮时,会调用 onRequestClose 回调。由于这是必需的属性,请注意,只要模态框处于打开状态,BackHandler 事件就不会被触发。 在 iOS 上,当 presentationStylepageSheetformSheet 时,使用拖拽手势关闭 Modal 会调用此回调。

类型
函数
必需
安卓
电视

函数
iOS

onShow

onShow 属性允许传递一个函数,该函数将在模态框显示后调用。

类型
函数

presentationStyle
iOS

presentationStyle 属性控制模态框如何出现(通常在较大设备上,如 iPad 或 Plus 尺寸的 iPhone)。详见 https://developer.apple.com/reference/uikit/uimodalpresentationstyle。

可能的值:

  • fullScreen 完全覆盖屏幕
  • pageSheet 覆盖居中的竖屏宽度视图(仅在较大设备上)
  • formSheet 覆盖居中的窄宽度视图(仅在较大设备上)
  • overFullScreen 完全覆盖屏幕,但允许透明
类型默认值
enum('fullScreen', 'pageSheet', 'formSheet', 'overFullScreen')transparent={false} 时为 fullScreen
transparent={true} 时为 overFullScreen

statusBarTranslucent
安卓

statusBarTranslucent 属性确定您的模态框是否应位于系统状态栏下方。

类型默认值
布尔值false

supportedOrientations
iOS

supportedOrientations 属性允许模态框旋转到任何指定的方向。在 iOS 上,模态框仍受应用的 Info.plist 中 UISupportedInterfaceOrientations 字段指定的限制。

当使用 pageSheetformSheetpresentationStyle 时,此属性将被 iOS 忽略。

类型默认值
枚举数组 ('portrait', 'portrait-upside-down', 'landscape', 'landscape-left', 'landscape-right')['portrait']

transparent

transparent 属性确定您的模态框是否将填充整个视图。将其设置为 true 将在透明背景上渲染模态框。

类型默认值
布尔值false

visible

visible 属性确定您的模态框是否可见。

类型默认值
布尔值true