Modal
Modal 组件是一种在封闭视图上方呈现内容的基本方式。
示例
参考
属性
视图属性
继承自 View 属性。
animated
请改用 animationType 属性。
animationType
animationType 属性控制 Modal 的动画方式。
可能的值
slide从底部滑入fade逐渐淡入none不带动画出现
| 类型 | 默认 |
|---|---|
枚举值('none', 'slide', 'fade') | 无 |
backdropColor
Modal 的 backdropColor（或 Modal 容器的背景色）。如果未提供且 transparent 为 false，则默认为 white。如果 transparent 为 true，则忽略。
| 类型 | 默认 |
|---|---|
| 颜色 | 白色 |
hardwareAccelerated Android
hardwareAccelerated 属性控制是否强制底层窗口进行硬件加速。
| 类型 | 默认 |
|---|---|
| 布尔值 | false |
navigationBarTranslucent Android
navigationBarTranslucent 属性决定您的 Modal 是否应该位于系统导航栏下方。但是，statusBarTranslucent 也需要设置为 true 才能使导航栏半透明。
| 类型 | 默认 |
|---|---|
| 布尔值 | false |
onDismiss iOS
onDismiss 属性允许传递一个函数，该函数将在 Modal 被关闭后调用。
| 类型 |
|---|
| 函数 |
onOrientationChange iOS
当 Modal 显示期间方向发生变化时，将调用 onOrientationChange 回调。提供的方向仅为“portrait”或“landscape”。无论当前方向如何，在初始渲染时也会调用此回调。
| 类型 |
|---|
| 函数 |
allowSwipeDismissal iOS
控制在 iOS 上是否可以通过向下滑动来关闭 Modal。这要求您实现 onRequestClose 属性来处理关闭。
| 类型 | 默认 |
|---|---|
| 布尔值 | false |
ref
一个 ref 设置器，在挂载时将被分配一个元素节点。
onRequestClose
当用户在 Android 上点击硬件返回按钮或在 Apple TV 上点击菜单按钮时，将调用 onRequestClose 回调。由于此必需属性，请注意，只要 Modal 处于打开状态，BackHandler 事件就不会被触发。在 iOS 上，当 Modal 在 presentationStyle 为 pageSheet 或 formSheet 时使用拖动手势关闭时，将调用此回调。当 allowSwipeDismissal 启用时，将在关闭 Modal 后调用此回调。
| 类型 |
|---|
| 函数 必需 Android 电视 函数 iOS |
onShow
onShow 属性允许传递一个函数，该函数将在 Modal 显示后调用。
| 类型 |
|---|
| 函数 |
presentationStyle iOS
presentationStyle 属性控制 Modal 的显示方式（通常在 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 属性决定您的 Modal 是否应该位于系统状态栏下方。
| 类型 | 默认 |
|---|---|
| 布尔值 | false |
supportedOrientations iOS
supportedOrientations 属性允许 Modal 旋转到任何指定的方向。在 iOS 上，Modal 仍然受到您的应用程序 Info.plist 的 UISupportedInterfaceOrientations 字段中指定内容的限制。
当使用 pageSheet 或 formSheet 的 presentationStyle 时，此属性在 iOS 上将被忽略。
| 类型 | 默认 |
|---|---|
枚举数组('portrait', 'portrait-upside-down', 'landscape', 'landscape-left', 'landscape-right') | ['portrait'] |
transparent
transparent 属性决定您的 Modal 是否会填充整个视图。将其设置为 true 将在透明背景上渲染 Modal。
| 类型 | 默认 |
|---|---|
| 布尔值 | false |
visible
visible 属性决定您的 Modal 是否可见。
| 类型 | 默认 |
|---|---|
| 布尔值 | true |