跳到主要内容

Modal

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

示例​

参考

属性​

View 属性​

继承自 View 属性。

animated​

已废弃。 请使用 animationType 属性。

animationType​

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

可能的值

  • slide 从底部滑入
  • fade 淡入视图
  • none 无动画直接出现
类型默认
枚举（'none'、'slide'、'fade'）无

backdropColor​

模态框的 backdropColor（或模态框容器的背景颜色）。如果未提供且 transparent 为 false，则默认为 white。如果 transparent 为 true，则忽略。

类型默认
颜色white

hardwareAccelerated
Android
​

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

类型默认
布尔值false

navigationBarTranslucent 属性决定你的模态框是否应该显示在系统导航栏下方。但是，statusBarTranslucent 也需要设置为 true 才能使导航栏半透明。

类型默认
布尔值false

onDismiss
iOS
​

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

类型
函数

onOrientationChange
iOS
​

当模态框显示时方向发生变化时，将调用 onOrientationChange 回调。提供的方向仅为“portrait”或“landscape”。此回调函数在首次渲染时也会调用，无论当前方向如何。

类型
函数

allowSwipeDismissal
iOS
​

控制 iOS 上是否可以通过向下滑动来关闭模态框。这要求你实现 onRequestClose 属性来处理关闭。

类型默认
布尔值false

onRequestClose​

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

类型
函数
必需
Android
电视
函数
iOS

onShow​

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

类型
函数

presentationStyle
iOS
​

presentationStyle 属性控制模态框的显示方式（通常在 iPad 或 Plus 大小的 iPhone 等大屏幕设备上）。有关详细信息，请参阅 https://developer.apple.com/reference/uikit/uimodalpresentationstyle。

可能的值

  • fullScreen 完全覆盖屏幕
  • pageSheet 覆盖屏幕中央的纵向宽度视图（仅限大屏幕设备）
  • formSheet 覆盖屏幕中央的窄宽度视图（仅限大屏幕设备）
  • overFullScreen 完全覆盖屏幕，但允许透明
类型默认
枚举（'fullScreen'、'pageSheet'、'formSheet'、'overFullScreen'）如果 transparent={false} 则为 fullScreen
如果 transparent={true} 则为 overFullScreen

statusBarTranslucent
Android
​

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