summaryrefslogtreecommitdiffstats
path: root/ash/system/web_notification/web_notification_tray.h
blob: 63956c2aacbbed5233164b775e1016d25c562630 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef ASH_SYSTEM_NOTIFICATION_WEB_NOTIFICATION_TRAY_H_
#define ASH_SYSTEM_NOTIFICATION_WEB_NOTIFICATION_TRAY_H_

#include "ash/ash_export.h"
#include "ash/system/tray/tray_background_view.h"
#include "ash/system/user/login_status.h"
#include "base/gtest_prod_util.h"
#include "ui/aura/event_filter.h"

namespace aura {
class LocatedEvent;
}

namespace gfx {
class ImageSkia;
}

namespace views {
class ImageView;
}

namespace ash {

namespace internal {
class StatusAreaWidget;
class WebNotificationList;
}

// Status area tray for showing browser and app notifications. The client
// (e.g. Chrome) calls [Add|Remove|Update]Notification to create and update
// notifications in the tray. It can also implement Delegate to receive
// callbacks when a notification is removed (closed), clicked on, or a menu
// item is triggered.
//
// Note: These are not related to system notifications (i.e NotificationView
// generated by SystemTrayItem). Visibility of one notification type or other
// is controlled by StatusAreaWidget.

class ASH_EXPORT WebNotificationTray : public internal::TrayBackgroundView {
 public:
  class Delegate {
   public:
    virtual ~Delegate() {}

    // Called when the notification associated with |notification_id| is
    // removed (i.e. closed by the user).
    virtual void NotificationRemoved(const std::string& notifcation_id) = 0;

    // Request to disable the extension associated with |notification_id|.
    virtual void DisableExtension(const std::string& notifcation_id) = 0;

    // Request to disable notifications from the source of |notification_id|.
    virtual void DisableNotificationsFromSource(
        const std::string& notifcation_id) = 0;

    // Request to show the notification settings (|notification_id| is used
    // to identify the requesting browser context).
    virtual void ShowSettings(const std::string& notifcation_id) = 0;

    // Called when the notification body is clicked on.
    virtual void OnClicked(const std::string& notifcation_id) = 0;
  };

  explicit WebNotificationTray(internal::StatusAreaWidget* status_area_widget);
  virtual ~WebNotificationTray();

  // Called once to set the delegate.
  void SetDelegate(Delegate* delegate);

  // Add a new notification. |id| is a unique identifier, used to update or
  // remove notifications. |title| and |meesage| describe the notification text.
  // Use SetNotificationImage to set the icon image. If |extension_id| is
  // provided then 'Disable extension' will appear in a dropdown menu and the
  // id will be used to disable notifications from the extension. Otherwise if
  // |display_source| is provided, a menu item showing the source and allowing
  // notifications from that source to be disabled will be shown. All actual
  // disabling is handled by the Delegate.
  void AddNotification(const std::string& id,
                       const string16& title,
                       const string16& message,
                       const string16& display_source,
                       const std::string& extension_id);

  // Update an existing notification.
  void UpdateNotification(const std::string& id,
                          const string16& title,
                          const string16& message);

  // Remove an existing notification and notify the delegate.
  void RemoveNotification(const std::string& id);

  // Remove all notifications and notify the delegate.
  void RemoveAllNotifications();

  // Set the notification image.
  void SetNotificationImage(const std::string& id,
                            const gfx::ImageSkia& image);

  // Disable all notifications matching notification |id|.
  void DisableByExtension(const std::string& id);
  void DisableByUrl(const std::string& id);

  // Show the notification bubble. Should only be called by StatusAreaWidget.
  void ShowBubble();

  // Hide the notification bubble. Should only be called by StatusAreaWidget.
  void HideBubble();

  // Updates tray visibility login status of the system changes.
  void UpdateAfterLoginStatusChange(user::LoginStatus login_status);

  // Request the Delegate to the settings dialog.
  void ShowSettings(const std::string& id);

  // Called when a notification is clicked on. Event is passed to the Delegate.
  void OnClicked(const std::string& id);

  internal::StatusAreaWidget* status_area_widget() {
    return status_area_widget_;
  }

  // Overridden from TrayBackgroundView.
  virtual void SetShelfAlignment(ShelfAlignment alignment) OVERRIDE;

  // Overridden from internal::ActionableView.
  virtual bool PerformAction(const views::Event& event) OVERRIDE;

 private:
  class Bubble;
  class BubbleContentsView;
  FRIEND_TEST_ALL_PREFIXES(WebNotificationTrayTest, WebNotifications);

  int GetNotificationCount() const;
  void UpdateIcon();
  void UpdateBubbleAndIcon();

  const internal::WebNotificationList* notification_list() const {
    return notification_list_.get();
  }
  views::View* tray_container() const { return tray_container_; }
  Bubble* bubble() const { return bubble_.get(); }

  internal::StatusAreaWidget* status_area_widget_;  // Unowned parent.
  scoped_ptr<internal::WebNotificationList> notification_list_;
  scoped_ptr<Bubble> bubble_;
  views::View* tray_container_;
  views::ImageView* icon_;
  Delegate* delegate_;
  bool show_bubble_on_unlock_;

  DISALLOW_COPY_AND_ASSIGN(WebNotificationTray);
};

}  // namespace ash

#endif  // ASH_SYSTEM_NOTIFICATION_WEB_NOTIFICATION_TRAY_H_