跳到主内容

Modal

模态框组件是用来在封闭视图之上呈现内容的基本方式。

示例​

参考

属性​

视图属性​

继承视图属性。

animated​

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

animationType​

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

可能的值

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

backdropColor​

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

类型默认值
colorwhite

hardwareAccelerated
Android
​

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

类型默认值
boolfalse

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

类型默认值
boolfalse

onDismiss
iOS
​

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

类型
function

onOrientationChange
iOS
​

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

类型
function

onRequestClose​

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

类型
function
必需
Android
TV
function
iOS

onShow​

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

类型
function

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属性决定模态框是否应该在系统状态栏下方显示。

类型默认值
boolfalse

supportedOrientations
iOS
​

supportedOrientations属性允许模态框旋转到任何指定的方向。在 iOS 上，模态框仍受限于应用 Info.plist 中 UISupportedInterfaceOrientations 字段的设置。

当使用pageSheet或formSheet的presentationStyle时，iOS 将忽略此属性。

类型默认值
array of enums('portrait', 'portrait-upside-down', 'landscape', 'landscape-left', 'landscape-right')['portrait']

transparent​

transparent属性决定模态框是否会填充整个视图。将其设置为true将使模态框在透明背景上渲染。

类型默认值
boolfalse

visible​

visible属性决定模态框是否可见。

类型默认值
booltrue