跳到主要内容
版本:0.78

模态框

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

示例​


参考

属性​

View 属性​

继承 View 属性。


animated​

已弃用。 请改用 animationType 属性。


animationType​

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

可能的值:

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

backdropColor​

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

类型默认值
颜色white

hardwareAccelerated
安卓
​

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

类型默认值
布尔值false

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

类型默认值
布尔值false

onDismiss
iOS
​

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

类型
函数

onOrientationChange
iOS
​

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

类型
函数

onRequestClose​

当用户在 Android 上按下硬件返回按钮,或在 Apple TV 上按下菜单按钮时,会调用 onRequestClose 回调。由于这是必需的属性,请注意,只要模态框处于打开状态,BackHandler 事件就不会被触发。 在 iOS 上,当 presentationStyle 为 pageSheet 或 formSheet 时,使用拖拽手势关闭 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 字段指定的限制。

当使用 pageSheet 或 formSheet 的 presentationStyle 时,此属性将被 iOS 忽略。

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

transparent​

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

类型默认值
布尔值false

visible​

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

类型默认值
布尔值true