| title |
|---|
ion-app |
import Props from '@site/static/auto-generated/app/props.md'; import Events from '@site/static/auto-generated/app/events.md'; import Methods from '@site/static/auto-generated/app/methods.md'; import Parts from '@site/static/auto-generated/app/parts.md'; import CustomProps from '@site/static/auto-generated/app/custom-props.md'; import Slots from '@site/static/auto-generated/app/slots.md';
<title>ion-app: Container Element for an Ionic Application</title>import EncapsulationPill from '@components/page/api/EncapsulationPill';
App is a container element for an Ionic application. There should only be one <ion-app> element per project. An app can have many Ionic components including menus, headers, content, and footers. The overlay components get appended to the <ion-app> when they are presented.
Using ion-app enables the following behaviors:
- Keyboard Lifecycle Events without the need for any native plugins
- Hardware Back Button Listeners for customizing the hardware back button behavior on Android devices
- Status bar support in Capacitor or Cordova which allows users to scroll to the top of the view by tapping the status bar
- Scroll assist utilities which scroll the content so focused text inputs are not covered by the on-screen keyboard
- Ripple effect when activating buttons on Material Design mode
- Other tap and focus utilities which make the experience of using an Ionic app feel more native