diff --git a/images/ui/notifications/alert.png b/images/ui/notifications/alert.png deleted file mode 100644 index 8e3987882..000000000 Binary files a/images/ui/notifications/alert.png and /dev/null differ diff --git a/images/ui/notifications/banner.png b/images/ui/notifications/banner.png deleted file mode 100644 index 98fe846bc..000000000 Binary files a/images/ui/notifications/banner.png and /dev/null differ diff --git a/images/ui/notifications/notification_type_alert.png b/images/ui/notifications/notification_type_alert.png new file mode 100644 index 000000000..bc9426bc7 Binary files /dev/null and b/images/ui/notifications/notification_type_alert.png differ diff --git a/images/ui/notifications/notification_type_alert_dark.png b/images/ui/notifications/notification_type_alert_dark.png new file mode 100644 index 000000000..25525472f Binary files /dev/null and b/images/ui/notifications/notification_type_alert_dark.png differ diff --git a/images/ui/notifications/notification_type_balloon_action_not_required.png b/images/ui/notifications/notification_type_balloon_action_not_required.png new file mode 100644 index 000000000..0058aa3a3 Binary files /dev/null and b/images/ui/notifications/notification_type_balloon_action_not_required.png differ diff --git a/images/ui/notifications/notification_type_balloon_action_not_required_dark.png b/images/ui/notifications/notification_type_balloon_action_not_required_dark.png new file mode 100644 index 000000000..d35da4a01 Binary files /dev/null and b/images/ui/notifications/notification_type_balloon_action_not_required_dark.png differ diff --git a/images/ui/notifications/notification_type_banner_action_required_dialog.png b/images/ui/notifications/notification_type_banner_action_required_dialog.png new file mode 100644 index 000000000..0f1861da6 Binary files /dev/null and b/images/ui/notifications/notification_type_banner_action_required_dialog.png differ diff --git a/images/ui/notifications/notification_type_banner_action_required_dialog_dark.png b/images/ui/notifications/notification_type_banner_action_required_dialog_dark.png new file mode 100644 index 000000000..db3912f82 Binary files /dev/null and b/images/ui/notifications/notification_type_banner_action_required_dialog_dark.png differ diff --git a/images/ui/notifications/notification_type_banner_action_required_editor.png b/images/ui/notifications/notification_type_banner_action_required_editor.png new file mode 100644 index 000000000..bb0236b42 Binary files /dev/null and b/images/ui/notifications/notification_type_banner_action_required_editor.png differ diff --git a/images/ui/notifications/notification_type_banner_action_required_editor_dark.png b/images/ui/notifications/notification_type_banner_action_required_editor_dark.png new file mode 100644 index 000000000..bf62c2896 Binary files /dev/null and b/images/ui/notifications/notification_type_banner_action_required_editor_dark.png differ diff --git a/images/ui/notifications/sticky_toast.png b/images/ui/notifications/sticky_toast.png deleted file mode 100644 index 306b292c0..000000000 Binary files a/images/ui/notifications/sticky_toast.png and /dev/null differ diff --git a/images/ui/notifications/timed_toast.png b/images/ui/notifications/timed_toast.png deleted file mode 100644 index 5514b5e54..000000000 Binary files a/images/ui/notifications/timed_toast.png and /dev/null differ diff --git a/images/ui/notifications/toolwindow_balloon.png b/images/ui/notifications/toolwindow_balloon.png deleted file mode 100644 index d6515a054..000000000 Binary files a/images/ui/notifications/toolwindow_balloon.png and /dev/null differ diff --git a/topics/ui/controls/notification_types.md b/topics/ui/controls/notification_types.md index a48384fc3..02bf7408a 100644 --- a/topics/ui/controls/notification_types.md +++ b/topics/ui/controls/notification_types.md @@ -6,23 +6,22 @@ Notifications inform users about the status of user or system initiated operations. They can have different actions depending on the message. -There are four types of notifications: +Types of notifications: - Alert - [Banner](banner.md) -- [Balloon](balloon.md) -- Tool window balloon +- [Notification balloon](balloon.md) ## What notification to use -Choose a notification type based on a combination of these factors: +Choose a notification type based on a combination of two factors: -1. **User action:** is it required to proceed? +1. Is **user action** required to proceed? - Required immediately - Required, but not immediately - Not required -2. **Trigger location:** from where the notification was created? Options: +2. From what **context** the notification was initiated? - Editor - Tool window - Dialog @@ -30,76 +29,22 @@ Choose a notification type based on a combination of these factors: ### Alert -- User action: required -- Trigger location: any +An action is required immediately, in any context. -Examples: confirm restart or exit, choose were to open a new project. +![](notification_type_alert.png){width=706} ### Banner +[Main article](banner.md) +An action is required but not immediately, in the editor, tool windows, and dialogs. +![](notification_type_banner_action_required_editor.png){width=706} + +An action is not required in a dialog. +![](notification_type_banner_action_required_dialog.png){width=706} ### Notification balloon +[Main article](balloon.md) - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
User actionLocationTypeExamples
Required immediately - Any - Alert - -

Confirming restart

-

Opening projects in new window

-

When trying to rename a method, but a conflict is found

-

-
Required, but not immediately -

Editor

-

Tool window

-
Banner -

Configuring SDK for your project

-

Requiring a Gradle sync for tools to work properly

-

-
Other locationsSticky balloon - IDE and plugin updates - -
Not requiredTool windowTool window balloon -

Status of task completion

-

When Find Usages is invoked on a method, use a tool window balloon to show the feedback since the results will be found in the Find tool window

-

-
Timed balloon -

Module imported

-

Framework detection

-

-
+An action is not required to proceed, in any context except dialogs. + +![](notification_type_balloon_action_not_required.png){width=706}