ion-menu

shadow

The Menu component is a navigation drawer that slides in from the side of the current view. By default, it slides in from the left, but the side can be overridden. The menu will be displayed differently based on the mode, however the display type can be changed to any of the available menu types. The menu element should be a sibling to the root content element. There can be any number of menus attached to the content. These can be controlled from the templates, or programmatically using the MenuController.

Basic Usage

Menu Toggle

The ion-menu-toggle component can be used to create custom button that can open or close the menu.

Menu Types

The type property can be used to customize how menus display in your application.

Theming

CSS Shadow Parts

Interfaces

MenuCustomEvent

While not required, this interface can be used in place of the CustomEvent interface for stronger typing with Ionic events emitted from this component.

interface MenuCustomEvent<T = any> extends CustomEvent {
  detail: T;
  target: HTMLIonMenuElement;
}

Properties

contentId

Description	The id of the main content. When using a router this is typically ion-router-outlet. When not using a router, this is typically your main view's ion-content. This is not the id of the ion-content inside of your ion-menu.
Attribute	content-id
Type	string ｜ undefined
Default	undefined

disabled

Description	trueの場合、メニューは無効化される。
Attribute	disabled
Type	boolean
Default	false

maxEdgeStart

Description	The edge threshold for dragging the menu open. If a drag/swipe happens over this value, the menu is not triggered.
Attribute	max-edge-start
Type	number
Default	50

menuId

Description	メニューのIDです。
Attribute	menu-id
Type	string ｜ undefined
Default	undefined

side

Description	メニューがビューのどの側に配置されるべきか。
Attribute	side
Type	"end" ｜ "start"
Default	'start'

swipeGesture

Description	trueの場合、スワイプによるメニュー操作が有効になる。
Attribute	swipe-gesture
Type	boolean
Default	true

type

Description	The display type of the menu. Available options: "overlay", "reveal", "push".
Attribute	type
Type	string ｜ undefined
Default	undefined

Events

Name	Description
ionDidClose	メニューが閉じられたときに発します。
ionDidOpen	メニューが開いているときに発行されます。
ionWillClose	メニューが閉じられようとするときに発します。
ionWillOpen	メニューが開かれようとするときに発します。

Methods

close

Description	Closes the menu. If the menu is already closed or it can't be closed, it returns false.
Signature	close(animated?: boolean) => Promise<boolean>

isActive

Description	Returns true is the menu is active. A menu is active when it can be opened or closed, meaning it's enabled and it's not part of a ion-split-pane.
Signature	isActive() => Promise<boolean>

isOpen

Description	メニューが開いている場合は true を返します。
Signature	isOpen() => Promise<boolean>

open

Description	Opens the menu. If the menu is already open or it can't be opened, it returns false.
Signature	open(animated?: boolean) => Promise<boolean>

setOpen

Description	Opens or closes the button. If the operation can't be completed successfully, it returns false.
Signature	setOpen(shouldOpen: boolean, animated?: boolean) => Promise<boolean>

toggle

Description	Toggles the menu. If the menu is already open, it will try to close, otherwise it will try to open it. If the operation can't be completed successfully, it returns false.
Signature	toggle(animated?: boolean) => Promise<boolean>

CSS Shadow Parts

Name	Description
backdrop	メニューを開いているときに、メインコンテンツの上に表示される背景です。
container	メニューの内容を格納するコンテナです。

CSS Custom Properties

Name	Description
--background	メニューの背景
--height	メニューの高さ
--max-height	メニューの最大の高さ
--max-width	メニューの最大幅
--min-height	メニューの高さの最小値
--min-width	メニューの最小幅
--width	メニューの幅

Slots

No slots available for this component.