Modal
Modal 组件是在封闭视图之上呈现内容的基本方式。
示例
参考
属性
View 属性
继承 View 属性。
animated
已弃用。 请使用
animationType
属性代替。
animationType
animationType
属性控制模态框的动画方式。
可能的值
slide
从底部滑入fade
淡入视图none
无动画显示
类型 | 默认值 |
---|---|
enum('none' , 'slide' , 'fade' ) | none |
backdropColor
模态框的 backdropColor
(或模态框容器的背景颜色)。如果未提供且 transparent 为 false
,则默认为 white
。如果 transparent
为 true
,则忽略。
类型 | 默认值 |
---|---|
颜色 | 白色 |
hardwareAccelerated
Android
hardwareAccelerated
属性控制是否强制为底层窗口启用硬件加速。
类型 | 默认值 |
---|---|
布尔值 | false |
navigationBarTranslucent
Android
navigationBarTranslucent
属性确定您的模态框是否应位于系统导航栏下方。但是,statusBarTranslucent
也需要设置为 true
才能使导航栏变为半透明。
类型 | 默认值 |
---|---|
布尔值 | false |
onDismiss
iOS
onDismiss
属性允许传入一个函数,该函数将在模态框关闭后调用。
类型 |
---|
函数 |
onOrientationChange
iOS
当模态框显示时,方向更改时会调用 onOrientationChange
回调。提供的方向仅为 'portrait' 或 'landscape'。此回调也在初始渲染时调用,无论当前方向如何。
类型 |
---|
函数 |
onRequestClose
当用户在 Android 上点击硬件返回按钮或在 Apple TV 上点击菜单按钮时,会调用 onRequestClose
回调。由于此属性是必需的,请注意,只要模态框处于打开状态,就不会发出 BackHandler
事件。在 iOS 上,当使用拖动手势关闭 Modal 且 presentationStyle
为 pageSheet 或 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 字段中指定的方向。
当使用
pageSheet
或formSheet
的presentationStyle
时,iOS 将忽略此属性。
类型 | 默认值 |
---|---|
枚举数组 ('portrait' , 'portrait-upside-down' , 'landscape' , 'landscape-left' , 'landscape-right' ) | ['portrait'] |
transparent
transparent
属性确定您的模态框是否将填充整个视图。设置为 true
将在透明背景上渲染模态框。
类型 | 默认值 |
---|---|
布尔值 | false |
visible
visible
属性确定您的模态框是否可见。
类型 | 默认值 |
---|---|
布尔值 | true |