ion-split-pane
A split pane is useful when creating multi-view layouts. It allows UI elements, like menus, to be displayed as the viewport width increases.
If the device's screen width is below a certain size, the split pane will collapse and the menu will be hidden. This is ideal for creating an app that will be served in a browser and deployed through the app store to phones and tablets.
Setting Breakpoints
By default, the split pane will expand when the screen is larger than 992px. To customize this, pass a breakpoint in the
when
property. The when
property can accept a boolean value, any valid media query, or one of Ionic's predefined sizes.
<!-- can be "xs", "sm", "md", "lg", or "xl" -->
<ion-split-pane when="md"></ion-split-pane>
<!-- can be any valid media query https://developer.mozilla.org/en-US/docs/Web/CSS/Media_Queries/Using_media_queries -->
<ion-split-pane when="(min-width: 40px)"></ion-split-pane>
Size | Value | Description |
---|---|---|
xs | (min-width: 0px) | Show the split-pane when the min-width is 0px (meaning, always) |
sm |
(min-width: 576px) |
Show the split-pane when the min-width is 576px |
md |
(min-width: 768px) |
Show the split-pane when the min-width is 768px |
lg |
(min-width: 992px) |
Show the split-pane when the min-width is 992px (default break point) |
xl |
(min-width: 1200px) |
Show the split-pane when the min-width is 1200px |
Usage
<ion-split-pane contentId="menu-content">
<!-- our side menu -->
<ion-menu contentId="menu-content">
<ion-header>
<ion-toolbar>
<ion-title>Menu</ion-title>
</ion-toolbar>
</ion-header>
</ion-menu>
<!-- the main content -->
<ion-router-outlet id="menu-content"></ion-router-outlet>
</ion-split-pane>
<ion-split-pane content-id="menu-content">
<!-- our side menu -->
<ion-menu content-id="menu-content">
<ion-header>
<ion-toolbar>
<ion-title>Menu</ion-title>
</ion-toolbar>
</ion-header>
</ion-menu>
<!-- the main content -->
<ion-content id="menu-content">
<h1>Hello</h1>
</ion-content>
</ion-split-pane>
import React from 'react';
import {
IonSplitPane,
IonMenu,
IonHeader,
IonToolbar,
IonTitle,
IonRouterOutlet,
IonContent,
IonPage
} from '@ionic/react';
export const SplitPlaneExample: React.SFC<{}> = () => (
<IonContent>
<IonSplitPane contentId="menuContent">
{/*-- our side menu --*/}
<IonMenu contentId="menuContent">
<IonHeader>
<IonToolbar>
<IonTitle>Menu</IonTitle>
</IonToolbar>
</IonHeader>
</IonMenu>
{/*-- the main content --*/}
<IonPage id="menuContent"/>
</IonSplitPane>
</IonContent>
);
<template>
<ion-split-pane contentId="menu-content">
<!-- our side menu -->
<ion-menu contentId="menu-content">
<ion-header>
<ion-toolbar>
<ion-title>Menu</ion-title>
</ion-toolbar>
</ion-header>
</ion-menu>
<!-- the main content -->
<ion-router-outlet id="menu-content"></ion-router-outlet>
</ion-split-pane>
</template>
Properties
contentId | |
---|---|
Description | The content
|
Attribute | content-id |
Type | string | undefined |
disabled | |
Description | If |
Attribute | disabled |
Type | boolean |
Default | false |
when | |
Description | When the split-pane should be shown. Can be a CSS media query expression, or a shortcut expression. Can also be a boolean expression. |
Attribute | when |
Type | boolean | string |
Default | QUERY['lg'] |
Events
Name | Description |
---|---|
ionSplitPaneVisible | Expression to be called when the split-pane visibility has changed |
CSS Custom Properties
Name | Description |
---|---|
--border | Border between panes |