跳转到主要内容

Modal

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

示例


参考

属性

View 属性

继承 View 属性


animated

已弃用。 请使用 animationType 属性代替。


animationType

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

可能的值

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

backdropColor

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

类型默认值
颜色白色

hardwareAccelerated
Android

hardwareAccelerated 属性控制是否强制为底层窗口启用硬件加速。

类型默认值
布尔值false

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

类型默认值
布尔值false

onDismiss
iOS

onDismiss 属性允许传入一个函数,该函数将在模态框关闭后调用。

类型
函数

onOrientationChange
iOS

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

类型
函数

onRequestClose

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

类型
函数
必需
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