this repo has no description
1<!doctype html><html lang=en dir=ltr class="docs-wrapper plugin-docs plugin-id-default docs-version-0.79 docs-doc-page docs-doc-id-modal" data-has-hydrated=false><meta charset=UTF-8><meta name=generator content="Docusaurus v3.8.0"><title data-rh=true>Modal · React Native</title><meta data-rh=true name=viewport content="width=device-width, initial-scale=1.0"><meta data-rh=true property=og:url content=https://reactnative.dev/docs/modal><meta data-rh=true property=og:locale content=en><meta data-rh=true name=docusaurus_locale content=en><meta data-rh=true name=docsearch:language content=en><meta data-rh=true property=og:image content=https://reactnative.dev/img/logo-share.png><meta data-rh=true name=twitter:card content=summary_large_image><meta data-rh=true name=twitter:image content=https://reactnative.dev/img/logo-share.png><meta data-rh=true name=twitter:site content=@reactnative><meta data-rh=true name=docusaurus_version content=0.79><meta data-rh=true name=docusaurus_tag content=docs-default-0.79><meta data-rh=true name=docsearch:version content=0.79><meta data-rh=true name=docsearch:docusaurus_tag content=docs-default-0.79><meta data-rh=true property=og:title content="Modal · React Native"><meta data-rh=true name=description content="The Modal component is a basic way to present content above an enclosing view."><meta data-rh=true property=og:description content="The Modal component is a basic way to present content above an enclosing view."><link data-rh=true rel=icon href=/img/favicon.ico><link data-rh=true rel=canonical href=https://reactnative.dev/docs/modal><link data-rh=true rel=alternate href=https://reactnative.dev/docs/modal hreflang=en><link data-rh=true rel=alternate href=https://reactnative.dev/docs/modal hreflang=x-default><link data-rh=true rel=preconnect href=https://8TDSE0OHGQ-dsn.algolia.net crossorigin=anonymous><link rel=alternate type=application/rss+xml href=/blog/rss.xml title="React Native RSS Feed"><link rel=alternate type=application/atom+xml href=/blog/atom.xml title="React Native Atom Feed"><link rel=alternate type=application/json href=/blog/feed.json title="React Native JSON Feed"><link rel=preconnect href=https://www.google-analytics.com><script>window.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)},ga.l=+new Date,ga("create","UA-41298772-2","auto"),ga("send","pageview")</script><script async src=https://www.google-analytics.com/analytics.js></script><link rel=preconnect href=https://www.google-analytics.com><link rel=preconnect href=https://www.googletagmanager.com><script async src="https://www.googletagmanager.com/gtag/js?id=G-58L13S6BDP"></script><script>function gtag(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],gtag("js",new Date),gtag("config","G-58L13S6BDP",{})</script><link rel=search type=application/opensearchdescription+xml title="React Native" href=/opensearch.xml><link rel=icon href=/img/pwa/manifest-icon-512.png><link rel=manifest href=/manifest.json><meta name=theme-color content=#20232a><meta name=apple-mobile-web-app-capable content=yes><meta name=apple-mobile-web-app-status-bar-style content=#20232a><link rel=apple-touch-icon href=/img/pwa/manifest-icon-512.png><link rel=mask-icon href=/img/pwa/manifest-icon-512.png color=#06bcee><meta name=msapplication-TileImage href=/img/pwa/manifest-icon-512.png><meta name=msapplication-TileColor content=#20232a><script src=https://cdn.jsdelivr.net/npm/focus-visible@5.2.0/dist/focus-visible.min.js defer></script><script src=https://widget.surveymonkey.com/collect/website/js/tRaiETqnLgj758hTBazgd8ryO5qrZo8Exadq9qmt1wtm4_2FdZGEAKHDFEt_2BBlwwM4.js defer></script><script src=https://snack.expo.dev/embed.js defer></script><script src=https://platform.twitter.com/widgets.js async></script><link rel=stylesheet href=/assets/css/styles.883cb042.css><script src=/assets/js/runtime~main.8ac1e6f0.js defer></script><script src=/assets/js/main.341783f5.js defer></script><body class=navigation-with-keyboard><svg xmlns=http://www.w3.org/2000/svg style="display: none;"><defs>
2<symbol id=theme-svg-external-link viewBox="0 0 24 24"><path fill=currentColor d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></symbol>
3</defs></svg>
4<script>!function(){var t=function(){try{return new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}}()||function(){try{return window.localStorage.getItem("theme")}catch(t){}}();document.documentElement.setAttribute("data-theme",t||(window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light")),document.documentElement.setAttribute("data-theme-choice",t||"system")}(),function(){try{for(var[t,e]of new URLSearchParams(window.location.search).entries())if(t.startsWith("docusaurus-data-")){var a=t.replace("docusaurus-data-","data-");document.documentElement.setAttribute(a,e)}}catch(t){}}(),document.documentElement.setAttribute("data-announcement-bar-initially-dismissed",function(){try{return"true"===localStorage.getItem("docusaurus.announcement.dismiss")}catch(t){}return!1}())</script><div id=__docusaurus><div role=region aria-label="Skip to main content"><a class=skipToContent_oPtH href=#__docusaurus_skipToContent_fallback>Skip to main content</a></div><div class="theme-announcement-bar announcementBar_zJRd" style=background-color:#20232a;color:#fff role=banner><div class="content_bSb_ announcementBarContent_t7IR">Join us for React Conf on Oct 7-8. <a target=_blank rel="noopener noreferrer" href=https://conf.react.dev>Learn more</a>.</div></div><nav aria-label=Main class="theme-layout-navbar navbar navbar--fixed-top navbar--dark"><div class=navbar__inner><div class="theme-layout-navbar-left navbar__items"><button aria-label="Toggle navigation bar" aria-expanded=false class="navbar__toggle clean-btn" type=button><svg width=30 height=30 viewBox="0 0 30 30" aria-hidden=true><path stroke=currentColor stroke-linecap=round stroke-miterlimit=10 stroke-width=2 d="M4 7h22M4 15h22M4 23h22"/></svg></button><a class=navbar__brand href=/><div class=navbar__logo><img src=/img/header_logo.svg alt="React Native" class="themedComponent_siVc themedComponent--light_hHel"><img src=/img/header_logo.svg alt="React Native" class="themedComponent_siVc themedComponent--dark_yETr"></div><b class="navbar__title text--truncate">React Native</b></a><div class="navbar__item dropdown dropdown--hoverable"><a class=navbar__link aria-haspopup=true aria-expanded=false role=button href=/docs/modal>0.79</a><ul class=dropdown__menu><li><a class=dropdown__link href=/docs/next/modal>Next</a><li><a aria-current=page class="dropdown__link dropdown__link--active" href=/docs/modal>0.79</a><li><a class=dropdown__link href=/docs/0.78/modal>0.78</a><li><a class=dropdown__link href=/docs/0.77/modal>0.77</a><li><a class=dropdown__link href=/docs/0.76/modal>0.76</a><li><a class=dropdown__link href=/docs/0.75/modal>0.75</a><li><a class=dropdown__link href=/docs/0.74/modal>0.74</a><li><a class=dropdown__link href=/docs/0.73/modal>0.73</a><li><a class=dropdown__link href=/docs/0.72/modal>0.72</a><li><a class=dropdown__link href=/docs/0.71/modal>0.71</a><li><a class=dropdown__link href=/docs/0.70/modal>0.70</a><li><a class=dropdown__link href=/versions>All versions</a></ul></div></div><div class="theme-layout-navbar-right navbar__items navbar__items--right"><div class="navbar__item dropdown dropdown--hoverable dropdown--right"><a href=# aria-haspopup=true aria-expanded=false role=button class=navbar__link>Development</a><ul class=dropdown__menu><li><a class=dropdown__link href=/docs/getting-started>Guides</a><li><a aria-current=page class="dropdown__link dropdown__link--active" href=/docs/components-and-apis>Components</a><li><a class=dropdown__link href=/docs/accessibilityinfo>APIs</a><li><a class=dropdown__link href=/architecture/overview>Architecture</a></ul></div><a class="navbar__item navbar__link" href=/contributing/overview>Contributing</a><a class="navbar__item navbar__link" href=/community/overview>Community</a><a class="navbar__item navbar__link" href=/showcase>Showcase</a><a class="navbar__item navbar__link" href=/blog>Blog</a><a href=https://github.com/facebook/react-native target=_blank rel="noopener noreferrer" class="navbar__item navbar__link navbar-github-link" aria-label="GitHub repository"></a><div class="toggle_ki11 colorModeToggle_Hewu"><button class="clean-btn toggleButton_MMFG toggleButtonDisabled_Uw7m darkNavbarColorModeToggle_m8pZ" type=button disabled title="system mode" aria-label="Switch between dark and light mode (currently system mode)"><svg viewBox="0 0 24 24" width=24 height=24 aria-hidden=true class="toggleIcon_k9hJ lightToggleIcon_lgto"><path fill=currentColor d="M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"/></svg><svg viewBox="0 0 24 24" width=24 height=24 aria-hidden=true class="toggleIcon_k9hJ darkToggleIcon_U96C"><path fill=currentColor d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"/></svg><svg viewBox="0 0 24 24" width=24 height=24 aria-hidden=true class="toggleIcon_k9hJ systemToggleIcon_E5c0"><path fill=currentColor d="m12 21c4.971 0 9-4.029 9-9s-4.029-9-9-9-9 4.029-9 9 4.029 9 9 9zm4.95-13.95c1.313 1.313 2.05 3.093 2.05 4.95s-0.738 3.637-2.05 4.95c-1.313 1.313-3.093 2.05-4.95 2.05v-14c1.857 0 3.637 0.737 4.95 2.05z"/></svg></button></div><div class=navbarSearchContainer_bzqh><button type=button class="DocSearch DocSearch-Button" aria-label="Search (Command+K)"><span class=DocSearch-Button-Container><svg width=20 height=20 class=DocSearch-Search-Icon viewBox="0 0 20 20" aria-hidden=true><path d="M14.386 14.386l4.0877 4.0877-4.0877-4.0877c-2.9418 2.9419-7.7115 2.9419-10.6533 0-2.9419-2.9418-2.9419-7.7115 0-10.6533 2.9418-2.9419 7.7115-2.9419 10.6533 0 2.9419 2.9418 2.9419 7.7115 0 10.6533z" stroke=currentColor fill=none fill-rule=evenodd stroke-linecap=round stroke-linejoin=round /></svg><span class=DocSearch-Button-Placeholder>Search</span></span><span class=DocSearch-Button-Keys></span></button></div></div></div><div role=presentation class=navbar-sidebar__backdrop></div></nav><div id=__docusaurus_skipToContent_fallback class="theme-layout-main main-wrapper mainWrapper_MB5r"><div class=docsWrapper__sE8><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_iEvu" type=button></button><div class=docRoot_DfVB><aside class="theme-doc-sidebar-container docSidebarContainer_c7NB"><div class=sidebarViewport_KYo0><div class=sidebar_CUen><nav aria-label="Docs sidebar" class="menu thin-scrollbar menu_jmj1 menuWithAnnouncementBar_YufC"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class=menu__list-item-collapsible><a class="menu__link menu__link--sublist menu__link--sublist-caret menu__link--active" role=button aria-expanded=true href=/docs/components-and-apis>Core Components</a></div><ul class=menu__list><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/components-and-apis>Core Components and APIs</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/activityindicator>ActivityIndicator</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/button>Button</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/flatlist>FlatList</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/image>Image</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/imagebackground>ImageBackground</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/keyboardavoidingview>KeyboardAvoidingView</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link menu__link--active" aria-current=page tabindex=0 href=/docs/modal>Modal</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/pressable>Pressable</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/refreshcontrol>RefreshControl</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/scrollview>ScrollView</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/sectionlist>SectionList</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/statusbar>StatusBar</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/switch>Switch</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/text>Text</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/textinput>TextInput</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/touchablehighlight>TouchableHighlight</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/touchableopacity>TouchableOpacity</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/touchablewithoutfeedback>TouchableWithoutFeedback</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/view>View</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/virtualizedlist>VirtualizedList</a><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item"><div class=menu__list-item-collapsible><a class="menu__link menu__link--sublist menu__link--sublist-caret" role=button aria-expanded=true tabindex=0 href=/docs/drawerlayoutandroid>Android Components</a></div><ul class=menu__list><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class=menu__link tabindex=0 href=/docs/drawerlayoutandroid>DrawerLayoutAndroid</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class=menu__link tabindex=0 href=/docs/touchablenativefeedback>TouchableNativeFeedback</a></ul><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item"><div class=menu__list-item-collapsible><a class="menu__link menu__link--sublist menu__link--sublist-caret" role=button aria-expanded=true tabindex=0 href=/docs/inputaccessoryview>iOS Components</a></div><ul class=menu__list><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class=menu__link tabindex=0 href=/docs/inputaccessoryview>InputAccessoryView</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class=menu__link tabindex=0 href=/docs/safeareaview>SafeAreaView</a></ul></ul><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class=menu__list-item-collapsible><a class="menu__link menu__link--sublist menu__link--sublist-caret" role=button aria-expanded=false href=/docs/image-style-props>Props</a></div><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class=menu__list-item-collapsible><a class="menu__link menu__link--sublist menu__link--sublist-caret" role=button aria-expanded=false href=/docs/boxshadowvalue>Object Types</a></div></ul></nav></div></div></aside><main class=docMainContainer_a9sJ><div class="container padding-top--md padding-bottom--lg"><div class=row><div class="col docItemCol_Qr34"><div class=docItemContainer_tjFy><article><div class="tocCollapsible_wXna theme-doc-toc-mobile tocMobile_Ojys"><button type=button class="clean-btn tocCollapsibleButton_iI2p">On this page</button></div><div class="theme-doc-markdown markdown"><header><h1>Modal</h1></header><p>The Modal component is a basic way to present content above an enclosing view.</p>
5<h2 class="anchor anchorWithStickyNavbar_JmGV" id=example>Example<a href=#example class=hash-link aria-label="Direct link to Example" title="Direct link to Example"></a></h2>
6<div class=snack-player data-snack-name=Modal data-snack-description="Example usage" data-snack-files="%7B%22App.tsx%22%3A%7B%22type%22%3A%22CODE%22%2C%22contents%22%3A%22import%20React%2C%20%7BuseState%7D%20from%20'react'%3B%5Cnimport%20%7BAlert%2C%20Modal%2C%20StyleSheet%2C%20Text%2C%20Pressable%2C%20View%7D%20from%20'react-native'%3B%5Cnimport%20%7BSafeAreaView%2C%20SafeAreaProvider%7D%20from%20'react-native-safe-area-context'%3B%5Cn%5Cnconst%20App%20%3D%20()%20%3D%3E%20%7B%5Cn%20%20const%20%5BmodalVisible%2C%20setModalVisible%5D%20%3D%20useState(false)%3B%5Cn%20%20return%20(%5Cn%20%20%20%20%3CSafeAreaProvider%3E%5Cn%20%20%20%20%20%20%3CSafeAreaView%20style%3D%7Bstyles.centeredView%7D%3E%5Cn%20%20%20%20%20%20%20%20%3CModal%5Cn%20%20%20%20%20%20%20%20%20%20animationType%3D%5C%22slide%5C%22%5Cn%20%20%20%20%20%20%20%20%20%20transparent%3D%7Btrue%7D%5Cn%20%20%20%20%20%20%20%20%20%20visible%3D%7BmodalVisible%7D%5Cn%20%20%20%20%20%20%20%20%20%20onRequestClose%3D%7B()%20%3D%3E%20%7B%5Cn%20%20%20%20%20%20%20%20%20%20%20%20Alert.alert('Modal%20has%20been%20closed.')%3B%5Cn%20%20%20%20%20%20%20%20%20%20%20%20setModalVisible(!modalVisible)%3B%5Cn%20%20%20%20%20%20%20%20%20%20%7D%7D%3E%5Cn%20%20%20%20%20%20%20%20%20%20%3CView%20style%3D%7Bstyles.centeredView%7D%3E%5Cn%20%20%20%20%20%20%20%20%20%20%20%20%3CView%20style%3D%7Bstyles.modalView%7D%3E%5Cn%20%20%20%20%20%20%20%20%20%20%20%20%20%20%3CText%20style%3D%7Bstyles.modalText%7D%3EHello%20World!%3C%2FText%3E%5Cn%20%20%20%20%20%20%20%20%20%20%20%20%20%20%3CPressable%5Cn%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20style%3D%7B%5Bstyles.button%2C%20styles.buttonClose%5D%7D%5Cn%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20onPress%3D%7B()%20%3D%3E%20setModalVisible(!modalVisible)%7D%3E%5Cn%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%3CText%20style%3D%7Bstyles.textStyle%7D%3EHide%20Modal%3C%2FText%3E%5Cn%20%20%20%20%20%20%20%20%20%20%20%20%20%20%3C%2FPressable%3E%5Cn%20%20%20%20%20%20%20%20%20%20%20%20%3C%2FView%3E%5Cn%20%20%20%20%20%20%20%20%20%20%3C%2FView%3E%5Cn%20%20%20%20%20%20%20%20%3C%2FModal%3E%5Cn%20%20%20%20%20%20%20%20%3CPressable%5Cn%20%20%20%20%20%20%20%20%20%20style%3D%7B%5Bstyles.button%2C%20styles.buttonOpen%5D%7D%5Cn%20%20%20%20%20%20%20%20%20%20onPress%3D%7B()%20%3D%3E%20setModalVisible(true)%7D%3E%5Cn%20%20%20%20%20%20%20%20%20%20%3CText%20style%3D%7Bstyles.textStyle%7D%3EShow%20Modal%3C%2FText%3E%5Cn%20%20%20%20%20%20%20%20%3C%2FPressable%3E%5Cn%20%20%20%20%20%20%3C%2FSafeAreaView%3E%5Cn%20%20%20%20%3C%2FSafeAreaProvider%3E%5Cn%20%20)%3B%5Cn%7D%3B%5Cn%5Cnconst%20styles%20%3D%20StyleSheet.create(%7B%5Cn%20%20centeredView%3A%20%7B%5Cn%20%20%20%20flex%3A%201%2C%5Cn%20%20%20%20justifyContent%3A%20'center'%2C%5Cn%20%20%20%20alignItems%3A%20'center'%2C%5Cn%20%20%7D%2C%5Cn%20%20modalView%3A%20%7B%5Cn%20%20%20%20margin%3A%2020%2C%5Cn%20%20%20%20backgroundColor%3A%20'white'%2C%5Cn%20%20%20%20borderRadius%3A%2020%2C%5Cn%20%20%20%20padding%3A%2035%2C%5Cn%20%20%20%20alignItems%3A%20'center'%2C%5Cn%20%20%20%20shadowColor%3A%20'%23000'%2C%5Cn%20%20%20%20shadowOffset%3A%20%7B%5Cn%20%20%20%20%20%20width%3A%200%2C%5Cn%20%20%20%20%20%20height%3A%202%2C%5Cn%20%20%20%20%7D%2C%5Cn%20%20%20%20shadowOpacity%3A%200.25%2C%5Cn%20%20%20%20shadowRadius%3A%204%2C%5Cn%20%20%20%20elevation%3A%205%2C%5Cn%20%20%7D%2C%5Cn%20%20button%3A%20%7B%5Cn%20%20%20%20borderRadius%3A%2020%2C%5Cn%20%20%20%20padding%3A%2010%2C%5Cn%20%20%20%20elevation%3A%202%2C%5Cn%20%20%7D%2C%5Cn%20%20buttonOpen%3A%20%7B%5Cn%20%20%20%20backgroundColor%3A%20'%23F194FF'%2C%5Cn%20%20%7D%2C%5Cn%20%20buttonClose%3A%20%7B%5Cn%20%20%20%20backgroundColor%3A%20'%232196F3'%2C%5Cn%20%20%7D%2C%5Cn%20%20textStyle%3A%20%7B%5Cn%20%20%20%20color%3A%20'white'%2C%5Cn%20%20%20%20fontWeight%3A%20'bold'%2C%5Cn%20%20%20%20textAlign%3A%20'center'%2C%5Cn%20%20%7D%2C%5Cn%20%20modalText%3A%20%7B%5Cn%20%20%20%20marginBottom%3A%2015%2C%5Cn%20%20%20%20textAlign%3A%20'center'%2C%5Cn%20%20%7D%2C%5Cn%7D)%3B%5Cn%5Cnexport%20default%20App%3B%22%7D%7D" data-snack-dependencies=react-native-safe-area-context data-snack-platform=web data-snack-supported-platforms=android,ios data-snack-theme=light data-snack-preview=true data-snack-loading=lazy data-snack-device-frame=false></div>
7<hr>
8<h1>Reference</h1>
9<h2 class="anchor anchorWithStickyNavbar_JmGV" id=props>Props<a href=#props class=hash-link aria-label="Direct link to Props" title="Direct link to Props"></a></h2>
10<h3 class="anchor anchorWithStickyNavbar_JmGV" id=view-props><a href=/docs/view#props>View Props</a><a href=#view-props class=hash-link aria-label="Direct link to view-props" title="Direct link to view-props"></a></h3>
11<p>Inherits <a href=/docs/view#props>View Props</a>.</p>
12<hr>
13<h3 class="anchor anchorWithStickyNavbar_JmGV" id=animated><code>animated</code><a href=#animated class=hash-link aria-label="Direct link to animated" title="Direct link to animated"></a></h3>
14<blockquote>
15<p><strong>Deprecated.</strong> Use the <a href=/docs/modal#animationtype><code>animationType</code></a> prop instead.</p>
16</blockquote>
17<hr>
18<h3 class="anchor anchorWithStickyNavbar_JmGV" id=animationtype><code>animationType</code><a href=#animationtype class=hash-link aria-label="Direct link to animationtype" title="Direct link to animationtype"></a></h3>
19<p>The <code>animationType</code> prop controls how the modal animates.</p>
20<p>Possible values:</p>
21<ul>
22<li><code>slide</code> slides in from the bottom</li>
23<li><code>fade</code> fades into view</li>
24<li><code>none</code> appears without an animation</li>
25</ul>
26<table><thead><tr><th>Type<th>Default<tbody><tr><td>enum(<code>'none'</code>, <code>'slide'</code>, <code>'fade'</code>)<td><code>none</code></table>
27<hr>
28<h3 class="anchor anchorWithStickyNavbar_JmGV" id=backdropcolor><code>backdropColor</code><a href=#backdropcolor class=hash-link aria-label="Direct link to backdropcolor" title="Direct link to backdropcolor"></a></h3>
29<p>The <code>backdropColor</code> of the modal (or background color of the modal's container.) Defaults to <code>white</code> if not provided and transparent is <code>false</code>. Ignored if <code>transparent</code> is <code>true</code>.</p>
30<table><thead><tr><th>Type<th>Default<tbody><tr><td><a href=/docs/colors>color</a><td>white</table>
31<hr>
32<h3 class="anchor anchorWithStickyNavbar_JmGV" id=hardwareaccelerated-android><code>hardwareAccelerated</code> <div class="label android">Android</div><a href=#hardwareaccelerated-android class=hash-link aria-label="Direct link to hardwareaccelerated-android" title="Direct link to hardwareaccelerated-android"></a></h3>
33<p>The <code>hardwareAccelerated</code> prop controls whether to force hardware acceleration for the underlying window.</p>
34<table><thead><tr><th>Type<th>Default<tbody><tr><td>bool<td><code>false</code></table>
35<hr>
36<h3 class="anchor anchorWithStickyNavbar_JmGV" id=navigationbartranslucent-android><code>navigationBarTranslucent</code> <div class="label android">Android</div><a href=#navigationbartranslucent-android class=hash-link aria-label="Direct link to navigationbartranslucent-android" title="Direct link to navigationbartranslucent-android"></a></h3>
37<p>The <code>navigationBarTranslucent</code> prop determines whether your modal should go under the system navigation bar. However, <code>statusBarTranslucent</code> also needs to be set to <code>true</code> to make navigation bar translucent.</p>
38<table><thead><tr><th>Type<th>Default<tbody><tr><td>bool<td><code>false</code></table>
39<hr>
40<h3 class="anchor anchorWithStickyNavbar_JmGV" id=ondismiss-ios><code>onDismiss</code> <div class="label ios">iOS</div><a href=#ondismiss-ios class=hash-link aria-label="Direct link to ondismiss-ios" title="Direct link to ondismiss-ios"></a></h3>
41<p>The <code>onDismiss</code> prop allows passing a function that will be called once the modal has been dismissed.</p>
42<table><thead><tr><th>Type<tbody><tr><td>function</table>
43<hr>
44<h3 class="anchor anchorWithStickyNavbar_JmGV" id=onorientationchange-ios><code>onOrientationChange</code> <div class="label ios">iOS</div><a href=#onorientationchange-ios class=hash-link aria-label="Direct link to onorientationchange-ios" title="Direct link to onorientationchange-ios"></a></h3>
45<p>The <code>onOrientationChange</code> callback is called when the orientation changes while the modal is being displayed. The orientation provided is only 'portrait' or 'landscape'. This callback is also called on initial render, regardless of the current orientation.</p>
46<table><thead><tr><th>Type<tbody><tr><td>function</table>
47<hr>
48<h3 class="anchor anchorWithStickyNavbar_JmGV" id=onrequestclose><code>onRequestClose</code><a href=#onrequestclose class=hash-link aria-label="Direct link to onrequestclose" title="Direct link to onrequestclose"></a></h3>
49<p>The <code>onRequestClose</code> callback is called when the user taps the hardware back button on Android or the menu button on Apple TV. Because of this required prop, be aware that <code>BackHandler</code> events will not be emitted as long as the modal is open.
50On iOS, this callback is called when a Modal is being dismissed using a drag gesture when <code>presentationStyle</code> is <code>pageSheet or formSheet</code></p>
51<table><thead><tr><th>Type<tbody><tr><td>function <div class="label basic required">Required</div><div class="label android">Android</div><div class="label tv">TV</div><hr>function <div class="label ios">iOS</div></table>
52<hr>
53<h3 class="anchor anchorWithStickyNavbar_JmGV" id=onshow><code>onShow</code><a href=#onshow class=hash-link aria-label="Direct link to onshow" title="Direct link to onshow"></a></h3>
54<p>The <code>onShow</code> prop allows passing a function that will be called once the modal has been shown.</p>
55<table><thead><tr><th>Type<tbody><tr><td>function</table>
56<hr>
57<h3 class="anchor anchorWithStickyNavbar_JmGV" id=presentationstyle-ios><code>presentationStyle</code> <div class="label ios">iOS</div><a href=#presentationstyle-ios class=hash-link aria-label="Direct link to presentationstyle-ios" title="Direct link to presentationstyle-ios"></a></h3>
58<p>The <code>presentationStyle</code> prop controls how the modal appears (generally on larger devices such as iPad or plus-sized iPhones). See <a href=https://developer.apple.com/reference/uikit/uimodalpresentationstyle target=_blank rel="noopener noreferrer">https://developer.apple.com/reference/uikit/uimodalpresentationstyle</a> for details.</p>
59<p>Possible values:</p>
60<ul>
61<li><code>fullScreen</code> covers the screen completely</li>
62<li><code>pageSheet</code> covers portrait-width view centered (only on larger devices)</li>
63<li><code>formSheet</code> covers narrow-width view centered (only on larger devices)</li>
64<li><code>overFullScreen</code> covers the screen completely, but allows transparency</li>
65</ul>
66<table><thead><tr><th>Type<th>Default<tbody><tr><td>enum(<code>'fullScreen'</code>, <code>'pageSheet'</code>, <code>'formSheet'</code>, <code>'overFullScreen'</code>)<td><code>fullScreen</code> if <code>transparent={false}</code><hr><code>overFullScreen</code> if <code>transparent={true}</code></table>
67<hr>
68<h3 class="anchor anchorWithStickyNavbar_JmGV" id=statusbartranslucent-android><code>statusBarTranslucent</code> <div class="label android">Android</div><a href=#statusbartranslucent-android class=hash-link aria-label="Direct link to statusbartranslucent-android" title="Direct link to statusbartranslucent-android"></a></h3>
69<p>The <code>statusBarTranslucent</code> prop determines whether your modal should go under the system statusbar.</p>
70<table><thead><tr><th>Type<th>Default<tbody><tr><td>bool<td><code>false</code></table>
71<hr>
72<h3 class="anchor anchorWithStickyNavbar_JmGV" id=supportedorientations-ios><code>supportedOrientations</code> <div class="label ios">iOS</div><a href=#supportedorientations-ios class=hash-link aria-label="Direct link to supportedorientations-ios" title="Direct link to supportedorientations-ios"></a></h3>
73<p>The <code>supportedOrientations</code> prop allows the modal to be rotated to any of the specified orientations. On iOS, the modal is still restricted by what's specified in your app's Info.plist's UISupportedInterfaceOrientations field.</p>
74<blockquote>
75<p>When using <code>presentationStyle</code> of <code>pageSheet</code> or <code>formSheet</code>, this property will be ignored by iOS.</p>
76</blockquote>
77<table><thead><tr><th>Type<th>Default<tbody><tr><td>array of enums(<code>'portrait'</code>, <code>'portrait-upside-down'</code>, <code>'landscape'</code>, <code>'landscape-left'</code>, <code>'landscape-right'</code>)<td><code>['portrait']</code></table>
78<hr>
79<h3 class="anchor anchorWithStickyNavbar_JmGV" id=transparent><code>transparent</code><a href=#transparent class=hash-link aria-label="Direct link to transparent" title="Direct link to transparent"></a></h3>
80<p>The <code>transparent</code> prop determines whether your modal will fill the entire view. Setting this to <code>true</code> will render the modal over a transparent background.</p>
81<table><thead><tr><th>Type<th>Default<tbody><tr><td>bool<td><code>false</code></table>
82<hr>
83<h3 class="anchor anchorWithStickyNavbar_JmGV" id=visible><code>visible</code><a href=#visible class=hash-link aria-label="Direct link to visible" title="Direct link to visible"></a></h3>
84<p>The <code>visible</code> prop determines whether your modal is visible.</p>
85<table><thead><tr><th>Type<th>Default<tbody><tr><td>bool<td><code>true</code></table></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class=editButtons_t0bR><a href=https://github.com/facebook/react-native-website/edit/main/docs/modal.md target=_blank rel="noopener noreferrer" class=theme-edit-this-page><svg fill=currentColor height=20 width=20 viewBox="0 0 40 40" class=iconEdit_bHB7 aria-hidden=true><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"/></g></svg>Edit page for next release</a><a href=https://github.com/facebook/react-native-website/edit/main/website/versioned_docs/version-0.79/modal.md target=_blank rel="noopener noreferrer" class=theme-edit-this-page><svg fill=currentColor height=20 width=20 viewBox="0 0 40 40" class=iconEdit_bHB7 aria-hidden=true><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"/></g></svg>Edit page for current release</a></div><div class=lastUpdated_VsjB><span class=theme-last-updated>Last updated<!-- --> on <b><time datetime=2025-04-14T14:14:17.000Z itemprop=dateModified>Apr 14, 2025</time></b></span></div></div></footer></article><nav class="docusaurus-mt-lg pagination-nav" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href=/docs/keyboardavoidingview><div class=pagination-nav__sublabel>Previous</div><div class=pagination-nav__label>KeyboardAvoidingView</div></a><a class="pagination-nav__link pagination-nav__link--next" href=/docs/pressable><div class=pagination-nav__sublabel>Next</div><div class=pagination-nav__label>Pressable</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_XG6w thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href=#example class="table-of-contents__link toc-highlight">Example</a><li><a href=#props class="table-of-contents__link toc-highlight">Props</a><ul><li><a href=#view-props class="table-of-contents__link toc-highlight">View Props</a><li><a href=#animated class="table-of-contents__link toc-highlight"><code>animated</code></a><li><a href=#animationtype class="table-of-contents__link toc-highlight"><code>animationType</code></a><li><a href=#backdropcolor class="table-of-contents__link toc-highlight"><code>backdropColor</code></a><li><a href=#hardwareaccelerated-android class="table-of-contents__link toc-highlight"><code>hardwareAccelerated</code> <div class="label android">Android</div></a><li><a href=#navigationbartranslucent-android class="table-of-contents__link toc-highlight"><code>navigationBarTranslucent</code> <div class="label android">Android</div></a><li><a href=#ondismiss-ios class="table-of-contents__link toc-highlight"><code>onDismiss</code> <div class="label ios">iOS</div></a><li><a href=#onorientationchange-ios class="table-of-contents__link toc-highlight"><code>onOrientationChange</code> <div class="label ios">iOS</div></a><li><a href=#onrequestclose class="table-of-contents__link toc-highlight"><code>onRequestClose</code></a><li><a href=#onshow class="table-of-contents__link toc-highlight"><code>onShow</code></a><li><a href=#presentationstyle-ios class="table-of-contents__link toc-highlight"><code>presentationStyle</code> <div class="label ios">iOS</div></a><li><a href=#statusbartranslucent-android class="table-of-contents__link toc-highlight"><code>statusBarTranslucent</code> <div class="label android">Android</div></a><li><a href=#supportedorientations-ios class="table-of-contents__link toc-highlight"><code>supportedOrientations</code> <div class="label ios">iOS</div></a><li><a href=#transparent class="table-of-contents__link toc-highlight"><code>transparent</code></a><li><a href=#visible class="table-of-contents__link toc-highlight"><code>visible</code></a></ul></ul></div></div></div></div></main></div></div></div><footer class="theme-layout-footer footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="theme-layout-footer-column col footer__col"><div class=footer__title>Develop</div><ul class="footer__items clean-list"><li class=footer__item><a class=footer__link-item href=/docs/getting-started>Guides</a><li class=footer__item><a class=footer__link-item href=/docs/components-and-apis>Components</a><li class=footer__item><a class=footer__link-item href=/docs/accessibilityinfo>APIs</a><li class=footer__item><a class=footer__link-item href=/architecture/overview>Architecture</a></ul></div><div class="theme-layout-footer-column col footer__col"><div class=footer__title>Participate</div><ul class="footer__items clean-list"><li class=footer__item><a class=footer__link-item href=/showcase>Showcase</a><li class=footer__item><a class=footer__link-item href=/contributing/overview>Contributing</a><li class=footer__item><a class=footer__link-item href=/community/overview>Community</a><li class=footer__item><a href=https://reactnative.directory/ target=_blank rel="noopener noreferrer" class=footer__link-item>Directory<svg width=13.5 height=13.5 aria-hidden=true viewBox="0 0 24 24" class=iconExternalLink_2l9O><path fill=currentColor d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></svg></a><li class=footer__item><a href=https://stackoverflow.com/questions/tagged/react-native target=_blank rel="noopener noreferrer" class=footer__link-item>Stack Overflow<svg width=13.5 height=13.5 aria-hidden=true viewBox="0 0 24 24" class=iconExternalLink_2l9O><path fill=currentColor d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></svg></a></ul></div><div class="theme-layout-footer-column col footer__col"><div class=footer__title>Find us</div><ul class="footer__items clean-list"><li class=footer__item><a class=footer__link-item href=/blog>Blog</a><li class=footer__item><a href=https://x.com/reactnative target=_blank rel="noopener noreferrer" class=footer__link-item>X<svg width=13.5 height=13.5 aria-hidden=true viewBox="0 0 24 24" class=iconExternalLink_2l9O><path fill=currentColor d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></svg></a><li class=footer__item><a href=https://bsky.app/profile/reactnative.dev target=_blank rel="noopener noreferrer" class=footer__link-item>Bluesky<svg width=13.5 height=13.5 aria-hidden=true viewBox="0 0 24 24" class=iconExternalLink_2l9O><path fill=currentColor d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></svg></a><li class=footer__item><a href=https://github.com/facebook/react-native target=_blank rel="noopener noreferrer" class=footer__link-item>GitHub<svg width=13.5 height=13.5 aria-hidden=true viewBox="0 0 24 24" class=iconExternalLink_2l9O><path fill=currentColor d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></svg></a></ul></div><div class="theme-layout-footer-column col footer__col"><div class=footer__title>Explore More</div><ul class="footer__items clean-list"><li class=footer__item><a href=https://react.dev/ target=_blank rel="noopener noreferrer" class=footer__link-item>ReactJS<svg width=13.5 height=13.5 aria-hidden=true viewBox="0 0 24 24" class=iconExternalLink_2l9O><path fill=currentColor d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></svg></a><li class=footer__item><a href=https://opensource.fb.com/legal/privacy/ target=_blank rel="noopener noreferrer" class=footer__link-item>Privacy Policy<svg width=13.5 height=13.5 aria-hidden=true viewBox="0 0 24 24" class=iconExternalLink_2l9O><path fill=currentColor d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></svg></a><li class=footer__item><a href=https://opensource.fb.com/legal/terms/ target=_blank rel="noopener noreferrer" class=footer__link-item>Terms of Service<svg width=13.5 height=13.5 aria-hidden=true viewBox="0 0 24 24" class=iconExternalLink_2l9O><path fill=currentColor d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></svg></a></ul></div></div><div class="footer__bottom text--center"><div class=margin-bottom--sm><a href=https://opensource.fb.com/ rel="noopener noreferrer" class=footerLogoLink_tutC><img src=/img/oss_logo.svg alt="Meta Open Source Logo" class="footer__logo themedComponent_siVc themedComponent--light_hHel"><img src=/img/oss_logo.svg alt="Meta Open Source Logo" class="footer__logo themedComponent_siVc themedComponent--dark_yETr"></a></div><div class=footer__copyright>Copyright © 2025 Meta Platforms, Inc.</div></div></div></footer></div>