跳到主要内容
版本:0.78

Modal

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

示例


参考

属性

View 属性

继承 View 属性


animated

已弃用。 请改用 animationType 属性。


animationType

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

可能的值:

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

backdropColor

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

类型默认值
颜色white

hardwareAccelerated
Android

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

类型默认值
布尔值false

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

类型默认值
布尔值false

onDismiss
iOS

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

类型
函数

onOrientationChange
iOS

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

类型
函数

onRequestClose

onRequestClose 回调在用户在 Android 上点击硬件返回键或在 Apple TV 上点击菜单按钮时调用。由于此必需属性,请注意只要模态框打开,BackHandler 事件就不会被发出。 在 iOS 上,当 presentationStylepageSheetformSheet 时,如果使用拖动手势解散模态框,则调用此回调。

类型
函数
必需
Android
TV

函数
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
Android

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