ModalPanel
A ModalPanel is used to display information that:
Needs attention from users in order to give instructions or critical information.
Requires information in order to continue with a service or workflow.
ModalPanels interrupt a user's workflow by design. When active, a user is blocked from the TaskPanel or HomePanel content and cannot return to their previous workflow until the modal task is completed or the modal is dismissed. ModalPanels are used for short and non-frequent tasks, such as logging into an account, Bluetooth device pairing, editing something or management tasks. If a user needs to repeatably perform a task, consider making the task do-able from the main Panel.
Parameters
An entry point for this Panel to communicate with the rest of the system.
Properties
A callback to register for back presses in the system UI.
A dispatcher that dispatches back presses to callbacks. Components that need to react to back presses must add their callbacks to this dispatcher. The last added callback that is currently enabled receives the back press.
Inherited properties
Represents the panel. The descriptor can for example be used by other panels to show breadcrumbs when this panel is part of a stack of panels.
The dismissal state of this panel.
Unique identifier of a GenericPanel. Each ID is an increment of the previously created panel's ID
true
if the panel is currently attached.
Whether a panel wants to be removed from its frontend.
A destination that the information contained by this panel transitions to when this panel closes. By default it is null
, indicating the information does not transition anywhere.
The source of the information contained by this panel when the information transitions from another panel to this one. By default it is null
, indicating the information does not transition from any other particular panel.
Inherited functions
The fragment used when initially showing the panel. The fragment may be recreated by the system UI upon configuration changes.
Dismisses the panel. After this requestsRemoval will be set to true, causing the panel to be removed from its frontend through onRemovedFromFrontend. This destroys the lifecycle and prevents the panel from being shown again.
The PanelContext of an IviFragment identified by iviFragmentId.
Called when this panel is added to Frontend.panels, allowing it to be shown in the system UI.
Called when the panel is attached to the system UI.
Called when the panel has been detached from the system UI.
Called when the panel has been dismissed from the system UI, either through user interaction or other events. This causes requestsRemoval to be set to true. The panel will be removed from its frontend, causing onRemovedFromFrontend to be called. This destroys the lifecycle and prevents the panel from being shown again.
Called when the panel is being dismissed from the system UI, either through user interaction or other events. At this point the panel may still be visible due to the panel's exit animation.
Called when a panel is removed from a panel and can not be reused again, preventing it from being shown in the system UI.