/* -*- mode: js2; js2-basic-offset: 4; indent-tabs-mode: nil -*- */ const Clutter = imports.gi.Clutter; const Gtk = imports.gi.Gtk; const Lang = imports.lang; const Mainloop = imports.mainloop; const Meta = imports.gi.Meta; const Pango = imports.gi.Pango; const Shell = imports.gi.Shell; const Signals = imports.signals; const St = imports.gi.St; const Tweener = imports.ui.tweener; const Main = imports.ui.main; const Params = imports.misc.params; const ANIMATION_TIME = 0.2; const NOTIFICATION_TIMEOUT = 4; const SUMMARY_TIMEOUT = 1; const HIDE_TIMEOUT = 0.2; const LONGER_HIDE_TIMEOUT = 0.6; const BUTTON_ICON_SIZE = 36; const MAX_SOURCE_TITLE_WIDTH = 180; const State = { HIDDEN: 0, SHOWING: 1, SHOWN: 2, HIDING: 3 }; function _cleanMarkup(text) { // Support &, ", ', < and >, escape all other // occurrences of '&'. let _text = text.replace(/&(?!amp;|quot;|apos;|lt;|gt;)/g, '&'); // Support , , and , escape anything else // so it displays as raw markup. return _text.replace(/<(\/?[^biu]>|[^>\/][^>])/g, '<$1'); } // Notification: // @source: the notification's Source // @title: the title // @banner: the banner text // @params: optional additional params // // Creates a notification. In the banner mode, the notification // will show an icon, @title (in bold) and @banner, all on a single // line (with @banner ellipsized if necessary). // // The notification will be expandable if either it has additional // elements that were added to it or if the @banner text did not // fit fully in the banner mode. When the notification is expanded, // the @banner text from the top line is always removed. The complete // @banner text is added as the first element in the content section, // unless 'customContent' parameter with the value 'true' is specified // in @params. // // Additional notification content can be added with addActor() and // addBody() methods. The notification content is put inside a // scrollview, so if it gets too tall, the notification will scroll // rather than continue to grow. In addition to this main content // area, there is also a single-row action area, which is not // scrolled and can contain a single actor. The action area can // be set by calling setActionArea() method. There is also a // convenience method addButton() for adding a button to the action // area. // // @params can contain values for 'customContent', 'body', 'icon', // and 'clear' parameters. // // If @params contains a 'customContent' parameter with the value %true, // then @banner will not be shown in the body of the notification when the // notification is expanded and calls to update() will not clear the content // unless 'clear' parameter with value %true is explicitly specified. // // If @params contains a 'body' parameter, then that text will be added to // the content area (as with addBody()). // // By default, the icon shown is created by calling // source.createNotificationIcon(). However, if @params contains an 'icon' // parameter, the passed in icon will be used. // // If @params contains a 'clear' parameter with the value %true, then // the content and the action area of the notification will be cleared. // The content area is also always cleared if 'customContent' is false // because it might contain the @banner that didn't fit in the banner mode. function Notification(source, title, banner, params) { this._init(source, title, banner, params); } Notification.prototype = { _init: function(source, title, banner, params) { this.source = source; this.urgent = false; this.expanded = false; this._customContent = false; this._bannerBodyText = null; this._titleFitsInBannerMode = true; this._spacing = 0; this._hasFocus = false; this._lockTrayOnFocusGrab = false; // We use this._prevFocusedWindow and this._prevKeyFocusActor to return the // focus where it previously belonged after a focus grab, unless the user // has explicitly changed that. this._prevFocusedWindow = null; this._prevKeyFocusActor = null; this._focusWindowChangedId = 0; this._focusActorChangedId = 0; this._stageInputModeChangedId = 0; this._capturedEventId = 0; this._keyPressId = 0; source.connect('destroy', Lang.bind(this, this.destroy)); this.actor = new St.Table({ name: 'notification', reactive: true }); this.actor.connect('style-changed', Lang.bind(this, this._styleChanged)); this.actor.connect('button-release-event', Lang.bind(this, function (actor, event) { if (!this._actionArea || !this._actionArea.contains(event.get_source())) this.emit('clicked'); })); // The first line should have the title, followed by the // banner text, but ellipsized if they won't both fit. We can't // make St.Table or St.BoxLayout do this the way we want (don't // show banner at all if title needs to be ellipsized), so we // use Shell.GenericContainer. this._bannerBox = new Shell.GenericContainer(); this._bannerBox.connect('get-preferred-width', Lang.bind(this, this._bannerBoxGetPreferredWidth)); this._bannerBox.connect('get-preferred-height', Lang.bind(this, this._bannerBoxGetPreferredHeight)); this._bannerBox.connect('allocate', Lang.bind(this, this._bannerBoxAllocate)); this.actor.add(this._bannerBox, { row: 0, col: 1, y_expand: false, y_fill: false }); this._titleLabel = new St.Label(); this._bannerBox.add_actor(this._titleLabel); this._bannerLabel = new St.Label(); this._bannerBox.add_actor(this._bannerLabel); this.update(title, banner, params); Main.overview.connect('showing', Lang.bind(this, function() { this._toggleFocusGrabMode(); })); Main.overview.connect('hidden', Lang.bind(this, function() { this._toggleFocusGrabMode(); })); }, // update: // @title: the new title // @banner: the new banner // @params: as in the Notification constructor // // Updates the notification by regenerating its icon and updating // the title/banner. If @params.clear is %true, it will also // remove any additional actors/action buttons previously added. update: function(title, banner, params) { params = Params.parse(params, { customContent: false, body: null, icon: null, clear: false }); this._customContent = params.customContent; if (this._icon) this._icon.destroy(); // We always clear the content area if we don't have custom // content because it might contain the @banner that didn't // fit in the banner mode. if (this._scrollArea && (!this._customContent || params.clear)) { this._scrollArea.destroy(); this._scrollArea = null; this._contentArea = null; } if (this._actionArea && params.clear) { this._actionArea.destroy(); this._actionArea = null; this._buttonBox = null; } if (!this._scrollArea && !this._actionArea) this.actor.remove_style_class_name('multi-line-notification'); this._icon = params.icon || this.source.createNotificationIcon(); this.actor.add(this._icon, { row: 0, col: 0, x_expand: false, y_expand: false, y_fill: false, y_align: St.Align.START }); title = title ? _cleanMarkup(title.replace(/\n/g, ' ')) : ''; this._titleLabel.clutter_text.set_markup('' + title + ''); // Unless the notification has custom content, we save this._bannerBodyText // to add it to the content of the notification if the notification is // expandable due to other elements in its content area or due to the banner // not fitting fully in the single-line mode. this._bannerBodyText = this._customContent ? null : banner; banner = banner ? _cleanMarkup(banner.replace(/\n/g, ' ')) : ''; this._bannerLabel.clutter_text.set_markup(banner); this._bannerLabel.queue_relayout(); // Add the bannerBody now if we know for sure we'll need it if (this._bannerBodyText && this._bannerBodyText.indexOf('\n') > -1) this._addBannerBody(); if (params.body) this.addBody(params.body); this._updated(); }, // addActor: // @actor: actor to add to the body of the notification // // Appends @actor to the notification's body addActor: function(actor) { if (!this._scrollArea) { this.actor.add_style_class_name('multi-line-notification'); this._scrollArea = new St.ScrollView({ name: 'notification-scrollview', vscrollbar_policy: Gtk.PolicyType.AUTOMATIC, hscrollbar_policy: Gtk.PolicyType.NEVER, vshadows: true }); this.actor.add(this._scrollArea, { row: 1, col: 1 }); this._contentArea = new St.BoxLayout({ name: 'notification-body', vertical: true }); this._scrollArea.add_actor(this._contentArea); // If we know the notification will be expandable, we need to add // the banner text to the body as the first element. this._addBannerBody(); } this._contentArea.add(actor); this._updated(); }, // addBody: // @text: the text // // Adds a multi-line label containing @text to the notification. // // Return value: the newly-added label addBody: function(text) { let body = new St.Label(); body.clutter_text.line_wrap = true; body.clutter_text.line_wrap_mode = Pango.WrapMode.WORD_CHAR; body.clutter_text.ellipsize = Pango.EllipsizeMode.NONE; text = text ? _cleanMarkup(text) : ''; body.clutter_text.set_markup(text); this.addActor(body); return body; }, _addBannerBody: function() { if (this._bannerBodyText) { let text = this._bannerBodyText; this._bannerBodyText = null; this.addBody(text); } }, // scrollTo: // @side: St.Side.TOP or St.Side.BOTTOM // // Scrolls the content area (if scrollable) to the indicated edge scrollTo: function(side) { // Hack to force a relayout, since the caller probably // just added or removed something to scrollArea, and // the adjustment needs to reflect that. global.stage.get_actor_at_pos(Clutter.PickMode.REACTIVE, 0, 0); let adjustment = this._scrollArea.vscroll.adjustment; if (side == St.Side.TOP) adjustment.value = adjustment.lower; else if (side == St.Side.BOTTOM) adjustment.value = adjustment.upper; }, // setActionArea: // @actor: the actor // @props: (option) St.Table child properties // // Puts @actor into the action area of the notification, replacing // the previous contents setActionArea: function(actor, props) { if (this._actionArea) { this._actionArea.destroy(); this._actionArea = null; if (this._buttonBox) this._buttonBox = null; } else { this._addBannerBody(); } this._actionArea = actor; if (!props) props = {}; props.row = 2; props.col = 1; this.actor.add_style_class_name('multi-line-notification'); this.actor.add(this._actionArea, props); this._updated(); }, // addButton: // @id: the action ID // @label: the label for the action's button // // Adds a button with the given @label to the notification. All // action buttons will appear in a single row at the bottom of // the notification. // // If the button is clicked, the notification will emit the // %action-invoked signal with @id as a parameter addButton: function(id, label) { if (!this._buttonBox) { let box = new St.BoxLayout({ name: 'notification-actions' }); this.setActionArea(box, { x_expand: false, x_fill: false, x_align: St.Align.END }); this._buttonBox = box; } let button = new St.Button(); if (Gtk.IconTheme.get_default().has_icon(id)) { button.add_style_class_name('notification-icon-button'); button.child = St.TextureCache.get_default().load_icon_name(id, St.IconType.SYMBOLIC, BUTTON_ICON_SIZE); } else { button.add_style_class_name('notification-button'); button.label = label; } this._buttonBox.add(button); button.connect('clicked', Lang.bind(this, function() { this.emit('action-invoked', id); })); this._updated(); }, setUrgent: function(urgent) { this.urgent = urgent; }, _styleChanged: function() { let [hasSpacing, spacing] = this.actor.get_theme_node().get_length('spacing-columns', false); this._spacing = hasSpacing ? spacing : 0; }, _bannerBoxGetPreferredWidth: function(actor, forHeight, alloc) { let [titleMin, titleNat] = this._titleLabel.get_preferred_width(forHeight); let [bannerMin, bannerNat] = this._bannerLabel.get_preferred_width(forHeight); alloc.min_size = titleMin; alloc.natural_size = titleNat + this._spacing + bannerNat; }, _bannerBoxGetPreferredHeight: function(actor, forWidth, alloc) { [alloc.min_size, alloc.natural_size] = this._titleLabel.get_preferred_height(forWidth); }, _bannerBoxAllocate: function(actor, box, flags) { let [titleMinW, titleNatW] = this._titleLabel.get_preferred_width(-1); let [titleMinH, titleNatH] = this._titleLabel.get_preferred_height(-1); let [bannerMinW, bannerNatW] = this._bannerLabel.get_preferred_width(-1); let availWidth = box.x2 - box.x1; let titleBox = new Clutter.ActorBox(); titleBox.x1 = titleBox.y1 = 0; titleBox.x2 = Math.min(titleNatW, availWidth); titleBox.y2 = titleNatH; this._titleLabel.allocate(titleBox, flags); this._titleFitsInBannerMode = (titleNatW <= availWidth); let bannerFits = true; if (titleBox.x2 + this._spacing > availWidth) { this._bannerLabel.opacity = 0; bannerFits = false; } else { let bannerBox = new Clutter.ActorBox(); bannerBox.x1 = titleBox.x2 + this._spacing; bannerBox.y1 = 0; bannerBox.x2 = Math.min(bannerBox.x1 + bannerNatW, availWidth); bannerBox.y2 = titleNatH; bannerFits = (bannerBox.x1 + bannerNatW <= availWidth); this._bannerLabel.allocate(bannerBox, flags); // Make _bannerLabel visible if the entire notification // fits on one line, or if the notification is currently // unexpanded and only showing one line anyway. if (!this.expanded || (bannerFits && this.actor.row_count == 1)) this._bannerLabel.opacity = 255; } // If the banner doesn't fully fit in the banner box, we possibly need to add the // banner to the body. We can't do that from here though since that will force a // relayout, so we add it to the main loop. if (!bannerFits) Mainloop.idle_add(Lang.bind(this, function() { this._addBannerBody(); if (!this._titleFitsInBannerMode) this.actor.add_style_class_name('multi-line-notification'); this._updated(); return false; })); }, _updated: function() { if (this.expanded) this.expand(false); }, expand: function(animate) { this.expanded = true; // The banner is never shown when the title did not fit, so this // can be an if-else statement. if (!this._titleFitsInBannerMode) { // Remove ellipsization from the title label and make it wrap so that // we show the full title when the notification is expanded. this._titleLabel.clutter_text.line_wrap = true; this._titleLabel.clutter_text.line_wrap_mode = Pango.WrapMode.WORD_CHAR; this._titleLabel.clutter_text.ellipsize = Pango.EllipsizeMode.NONE; } else if (this.actor.row_count > 1 && this._bannerLabel.opacity != 0) { // We always hide the banner if the notification has additional content. // // We don't need to wrap the banner that doesn't fit the way we wrap the // title that doesn't fit because we won't have a notification with // row_count=1 that has a banner that doesn't fully fit. We'll either add // that banner to the content of the notification in _bannerBoxAllocate() // or the notification will have custom content. if (animate) Tweener.addTween(this._bannerLabel, { opacity: 0, time: ANIMATION_TIME, transition: 'easeOutQuad' }); else this._bannerLabel.opacity = 0; } this.emit('expanded'); }, collapseCompleted: function() { this.expanded = false; // Make sure we don't line wrap the title, and ellipsize it instead. this._titleLabel.clutter_text.line_wrap = false; this._titleLabel.clutter_text.ellipsize = Pango.EllipsizeMode.END; // Restore banner opacity in case the notification is shown in the // banner mode again on update. this._bannerLabel.opacity = 255; }, grabFocus: function(lockTray) { if (this._hasFocus) return; this._lockTrayOnFocusGrab = lockTray; let metaDisplay = global.screen.get_display(); this._prevFocusedWindow = metaDisplay.focus_window; this._prevKeyFocus = global.stage.get_key_focus(); // We need to use the captured event in the overview, because we don't want to change the stage input mode to // FOCUSED there. On the other hand, using the captured event doesn't work correctly in the main view because // it doesn't allow focusing the windows again correctly. So we are using the FOCUSED stage input mode in the // main view. if (Main.overview.visible) { if (!Main.pushModal(this.actor)) return; this._capturedEventId = global.stage.connect('captured-event', Lang.bind(this, this._onCapturedEvent)); } else { global.set_stage_input_mode(Shell.StageInputMode.FOCUSED); this._focusWindowChangedId = metaDisplay.connect('notify::focus-window', Lang.bind(this, this._focusWindowChanged)); this._stageInputModeChangedId = global.connect('notify::stage-input-mode', Lang.bind(this, this._stageInputModeChanged)); this._keyPressId = global.stage.connect('key-press-event', Lang.bind(this, this._onKeyPress)); } // We need to listen to this signal in the overview, as well as in the main view, to make the key bindings such as // Alt+F2 work. When a notification has key focus, which is the case with chat notifications, all captured KEY_PRESS // events have the actor with the key focus as their source. This makes it impossible to distinguish between the chat // window input and the key bindings based solely on the KEY_PRESS event. this._focusActorChangedId = global.stage.connect('notify::key-focus', Lang.bind(this, this._focusActorChanged)); this._hasFocus = true; if (lockTray) Main.messageTray.lock(); }, _focusWindowChanged: function() { let metaDisplay = global.screen.get_display(); // this._focusWindowChanged() will be called when we call // global.set_stage_input_mode(Shell.StageInputMode.FOCUSED) , // however metaDisplay.focus_window will be null in that case. We only // want to ungrab focus if the focus has been moved to an application // window. if (metaDisplay.focus_window) { this._prevFocusedWindow = null; this.ungrabFocus(); } }, _focusActorChanged: function() { let focusedActor = global.stage.get_key_focus(); if (!focusedActor || !this.actor.contains(focusedActor)) { this._prevKeyFocusActor = null; this.ungrabFocus(); } }, _stageInputModeChanged: function() { let focusedActor = global.stage.get_key_focus(); // TODO: We need to set this._prevFocusedWindow to null in order to // get the cursor in the run dialog. However, that also means it's // set to null when the application menu is activated, which defeats // the point of keeping the name of the previously focused application // in the panel. It'd be good to be able to distinguish between these // two cases. this._prevFocusedWindow = null; this._prevKeyFocusActor = null; this.ungrabFocus(); }, _onCapturedEvent: function(actor, event) { let source = event.get_source(); switch (event.type()) { case Clutter.EventType.BUTTON_PRESS: if (!this.actor.contains(source)) this.ungrabFocus(); break; case Clutter.EventType.KEY_PRESS: let symbol = event.get_key_symbol(); if (symbol == Clutter.Escape) { Main.messageTray.escapeTray(); return true; } break; } return false; }, _onKeyPress: function(actor, event) { let symbol = event.get_key_symbol(); if (symbol == Clutter.Escape) { Main.messageTray.escapeTray(); return true; } return false; }, ungrabFocus: function() { if (!this._hasFocus) return; let metaDisplay = global.screen.get_display(); if (this._focusWindowChangedId > 0) { metaDisplay.disconnect(this._focusWindowChangedId); this._focusWindowChangedId = 0; } if (this._focusActorChangedId > 0) { global.stage.disconnect(this._focusActorChangedId); this._focusActorChangedId = 0; } if (this._stageInputModeChangedId) { global.disconnect(this._stageInputModeChangedId); this._stageInputModeChangedId = 0; } if (this._capturedEventId > 0) { Main.popModal(this.actor); global.stage.disconnect(this._capturedEventId); this._capturedEventId = 0; } if (this._keyPressId > 0) { global.stage.disconnect(this._keyPressId); this._keyPressId = 0; } this._hasFocus = false; Main.messageTray.unlock(); if (this._prevFocusedWindow) { metaDisplay.set_input_focus_window(this._prevFocusedWindow, false, global.get_current_time()); this._prevFocusedWindow = null; } if (this._prevKeyFocusActor) { global.stage.set_key_focus(this._prevKeyFocusActor); this._prevKeyFocusActor = null; } else { // We don't want to keep the actor inside the notification focused. let focusedActor = global.stage.get_key_focus(); if (focusedActor && this.actor.contains(focusedActor)) global.stage.set_key_focus(null); } }, // Because we grab focus differently in the overview // and in the main view, we need to change how it is // done when we move between the two. _toggleFocusGrabMode: function() { if (this._hasFocus) { this.ungrabFocus(); this.grabFocus(this._lockTrayOnFocusGrab); } }, destroy: function() { this.emit('destroy'); } }; Signals.addSignalMethods(Notification.prototype); function Source(title) { this._init(title); } Source.prototype = { ICON_SIZE: 24, _init: function(title) { this.title = title; this._iconBin = new St.Bin({ width: this.ICON_SIZE, height: this.ICON_SIZE }); }, // Called to create a new icon actor (of size this.ICON_SIZE). // Must be overridden by the subclass if you do not pass icons // explicitly to the Notification() constructor. createNotificationIcon: function() { throw new Error('no implementation of createNotificationIcon in ' + this); }, // Unlike createNotificationIcon, this always returns the same actor; // there is only one summary icon actor for a Source. getSummaryIcon: function() { return this._iconBin; }, notify: function(notification) { if (this.notification) { this.notification.disconnect(this._notificationClickedId); this.notification.disconnect(this._notificationDestroyedId); } this.notification = notification; this._notificationClickedId = notification.connect('clicked', Lang.bind(this, this._notificationClicked)); this._notificationDestroyedId = notification.connect('destroy', Lang.bind(this, function () { if (this.notification == notification) { this.notification = null; this._notificationDestroyedId = 0; this._notificationClickedId = 0; } })); this.emit('notify', notification); }, destroy: function() { this.emit('destroy'); }, //// Protected methods //// // The subclass must call this at least once to set the summary icon. _setSummaryIcon: function(icon) { if (this._iconBin.child) this._iconBin.child.destroy(); this._iconBin.child = icon; }, // Default implementation is to do nothing, but subclass can override _notificationClicked: function(notification) { } }; Signals.addSignalMethods(Source.prototype); function SummaryItem(source) { this._init(source); } SummaryItem.prototype = { _init: function(source) { this.source = source; this.actor = new St.Button({ style_class: 'summary-source-button', reactive: true, track_hover: true }); this._sourceBox = new St.BoxLayout({ style_class: 'summary-source' }); this._sourceIcon = source.getSummaryIcon(); this._sourceTitleBin = new St.Bin({ y_align: St.Align.MIDDLE, x_fill: true, clip_to_allocation: true }); this._sourceTitle = new St.Label({ style_class: 'source-title', text: source.title }); this._sourceTitle.clutter_text.ellipsize = Pango.EllipsizeMode.NONE; this._sourceTitleBin.child = this._sourceTitle; this._sourceTitleBin.width = 0; this._sourceBox.add_actor(this._sourceIcon); this._sourceBox.add_actor(this._sourceTitleBin, { expand: true }); this.actor.child = this._sourceBox; }, // getTitleNaturalWidth, getTitleWidth, and setTitleWidth include // the spacing between the icon and title (which is actually // _sourceTitle's padding-left) as part of the width. getTitleNaturalWidth: function() { let [minWidth, naturalWidth] = this._sourceTitle.get_preferred_width(-1); return Math.min(naturalWidth, MAX_SOURCE_TITLE_WIDTH); }, getTitleWidth: function() { return this._sourceTitleBin.width; }, setTitleWidth: function(width) { width = Math.round(width); if (width != this._sourceTitleBin.width) this._sourceTitleBin.width = width; }, setEllipsization: function(mode) { this._sourceTitle.clutter_text.ellipsize = mode; } }; function MessageTray() { this._init(); } MessageTray.prototype = { _init: function() { this.actor = new St.Group({ name: 'message-tray', reactive: true, track_hover: true }); this.actor.connect('notify::hover', Lang.bind(this, this._onTrayHoverChanged)); this._notificationBin = new St.Bin(); this.actor.add_actor(this._notificationBin); this._notificationBin.hide(); this._notificationQueue = []; this._notification = null; this._summaryBin = new St.Bin({ anchor_gravity: Clutter.Gravity.NORTH_EAST }); this.actor.add_actor(this._summaryBin); this._summary = new St.BoxLayout({ name: 'summary-mode', reactive: true, track_hover: true }); this._summary.connect('notify::hover', Lang.bind(this, this._onSummaryHoverChanged)); this._summaryBin.child = this._summary; this._summaryBin.opacity = 0; this._summaryNotificationBin = new St.Bin({ name: 'summary-notification-bin', anchor_gravity: Clutter.Gravity.NORTH_EAST, reactive: true, track_hover: true }); this.actor.add_actor(this._summaryNotificationBin); this._summaryNotificationBin.lower_bottom(); this._summaryNotificationBin.hide(); this._summaryNotification = null; this._clickedSummaryItem = null; this._expandedSummaryItem = null; this._summaryItemTitleWidth = 0; // To simplify the summary item animation code, we pretend // that there's an invisible SummaryItem to the left of the // leftmost real summary item, and that it's expanded when all // of the other items are collapsed. this._imaginarySummaryItemTitleWidth = 0; this._trayState = State.HIDDEN; this._locked = false; this._useLongerTrayLeftTimeout = false; this._trayLeftTimeoutId = 0; this._pointerInTray = false; this._summaryState = State.HIDDEN; this._summaryTimeoutId = 0; this._pointerInSummary = false; this._notificationState = State.HIDDEN; this._notificationTimeoutId = 0; this._notificationExpandedId = 0; this._summaryNotificationState = State.HIDDEN; this._summaryNotificationTimeoutId = 0; this._summaryNotificationExpandedId = 0; this._overviewVisible = Main.overview.visible; this._notificationRemoved = false; this._reNotifyWithSummaryNotificationAfterHide = false; Main.chrome.addActor(this.actor, { affectsStruts: false, visibleInOverview: true }); Main.chrome.trackActor(this._notificationBin); Main.chrome.trackActor(this._summaryNotificationBin); global.gdk_screen.connect('monitors-changed', Lang.bind(this, this._setSizePosition)); this._setSizePosition(); Main.overview.connect('showing', Lang.bind(this, function() { this._overviewVisible = true; if (this._locked) this.unlock(); else this._updateState(); })); Main.overview.connect('hiding', Lang.bind(this, function() { this._overviewVisible = false; if (this._locked) this.unlock(); else this._updateState(); })); this._summaryItems = []; // We keep a list of new summary items that were added to the summary since the last // time it was shown to the user. We automatically show the summary to the user if there // are items in this list once the notifications are done showing or once an item gets // added to the summary without a notification being shown. this._newSummaryItems = []; this._longestSummaryItem = null; }, _setSizePosition: function() { let primary = global.get_primary_monitor(); this.actor.x = primary.x; this.actor.y = primary.y + primary.height - 1; this.actor.width = primary.width; this._notificationBin.x = 0; this._notificationBin.width = primary.width; // These work because of their anchor_gravity this._summaryBin.x = primary.width; this._summaryNotificationBin.x = primary.width; }, contains: function(source) { return this._getIndexOfSummaryItemForSource(source) >= 0; }, _getIndexOfSummaryItemForSource: function(source) { for (let i = 0; i < this._summaryItems.length; i++) { if (this._summaryItems[i].source == source) return i; } return -1; }, add: function(source) { if (this.contains(source)) { log('Trying to re-add source ' + source.title); return; } let summaryItem = new SummaryItem(source); this._summary.insert_actor(summaryItem.actor, 0); let titleWidth = summaryItem.getTitleNaturalWidth(); if (titleWidth > this._summaryItemTitleWidth) { this._summaryItemTitleWidth = titleWidth; if (!this._expandedSummaryItem) this._imaginarySummaryItemTitleWidth = titleWidth; this._longestSummaryItem = summaryItem; } this._summaryItems.push(summaryItem); this._newSummaryItems.push(summaryItem); source.connect('notify', Lang.bind(this, this._onNotify)); summaryItem.actor.connect('notify::hover', Lang.bind(this, function () { this._onSummaryItemHoverChanged(summaryItem); })); summaryItem.actor.connect('clicked', Lang.bind(this, function () { this._onSummaryItemClicked(summaryItem); })); source.connect('destroy', Lang.bind(this, function () { this.removeSource(source); })); // We need to display the newly-added summary item, but if the // caller is about to post a notification, we want to show that // *first* and not show the summary item until after it hides. // So postpone calling _updateState() a tiny bit. Meta.later_add(Meta.LaterType.BEFORE_REDRAW, Lang.bind(this, function() { this._updateState(); return false; })); }, removeSource: function(source) { let index = this._getIndexOfSummaryItemForSource(source); if (index == -1) return; // remove all notifications with this source from the queue let newNotificationQueue = []; for (let i = 0; i < this._notificationQueue.length; i++) { if (this._notificationQueue[i].source != source) newNotificationQueue.push(this._notificationQueue[i]); } this._notificationQueue = newNotificationQueue; this._summary.remove_actor(this._summaryItems[index].actor); let newSummaryItemsIndex = this._newSummaryItems.indexOf(this._summaryItems[index]); if (newSummaryItemsIndex != -1) this._newSummaryItems.splice(newSummaryItemsIndex, 1); this._summaryItems.splice(index, 1); if (this._longestSummaryItem.source == source) { let newTitleWidth = 0; this._longestSummaryItem = null; for (let i = 0; i < this._summaryItems.length; i++) { let summaryItem = this._summaryItems[i]; let titleWidth = summaryItem.getTitleNaturalWidth(); if (titleWidth > newTitleWidth) { newTitleWidth = titleWidth; this._longestSummaryItem = summaryItem; } } this._summaryItemTitleWidth = newTitleWidth; if (!this._expandedSummaryItem) this._imaginarySummaryItemTitleWidth = newTitleWidth; } let needUpdate = false; if (this._notification && this._notification.source == source) { this._updateNotificationTimeout(0); this._notificationRemoved = true; needUpdate = true; } if (this._clickedSummaryItem && this._clickedSummaryItem.source == source) { this._clickedSummaryItem = null; needUpdate = true; } if (needUpdate); this._updateState(); }, removeNotification: function(notification) { if (this._notification == notification && (this._notificationState == State.SHOWN || this._notificationState == State.SHOWING)) { this._updateNotificationTimeout(0); this._notificationRemoved = true; this._updateState(); return; } let index = this._notificationQueue.indexOf(notification); if (index != -1) this._notificationQueue.splice(index, 1); }, lock: function() { this._locked = true; }, unlock: function() { if (!this._locked) return; this._locked = false; this._clickedSummaryItem = null; this._updateState(); }, _onNotify: function(source, notification) { if (notification == this._summaryNotification) { if (!this._summaryNotificationExpandedId) // We must be in the process of hiding the summary notification. // If the summary notification is updated while it is being // hidden, we show the update as a new notification. However, // we must first wait till the hide is complete and the // notification actor is not part of the stage. this._reNotifyWithSummaryNotificationAfterHide = true; return; } if (this._notification == notification) { // If a notification that is being shown is updated, we update // how it is shown and extend the time until it auto-hides. // If a new notification is updated while it is being hidden, // we stop hiding it and show it again. this._updateShowingNotification(); } else if (this._notificationQueue.indexOf(notification) < 0) { notification.connect('destroy', Lang.bind(this, this.removeNotification)); if (notification.urgent) this._notificationQueue.unshift(notification); else this._notificationQueue.push(notification); } this._updateState(); }, _onSummaryItemHoverChanged: function(summaryItem) { // We can't just animate individual summary items as the // pointer moves in and out of them, because if they don't // move in sync you get weird-looking wobbling. So whenever // there's a change, we have to re-tween the entire summary // area. if (summaryItem.actor.hover) { if (summaryItem == this._expandedSummaryItem) return; this._expandedSummaryItem = summaryItem; } else { if (summaryItem != this._expandedSummaryItem) return; this._expandedSummaryItem = null; // Turn off ellipsization while collapsing; it looks better summaryItem.setEllipsization(Pango.EllipsizeMode.NONE); } // We tween on a "_expandedSummaryItemTitleWidth" pseudo-property // that represents the current title width of the // expanded/expanding item, or the width of the imaginary // invisible item if we're collapsing everything. Tweener.addTween(this, { _expandedSummaryItemTitleWidth: this._summaryItemTitleWidth, time: ANIMATION_TIME, transition: 'easeOutQuad', onComplete: this._expandSummaryItemCompleted, onCompleteScope: this }); }, get _expandedSummaryItemTitleWidth() { if (this._expandedSummaryItem) return this._expandedSummaryItem.getTitleWidth(); else return this._imaginarySummaryItemTitleWidth; }, set _expandedSummaryItemTitleWidth(expansion) { // Expand the expanding item to its new width if (this._expandedSummaryItem) this._expandedSummaryItem.setTitleWidth(expansion); else this._imaginarySummaryItemTitleWidth = expansion; // Figure out how much space the other items are currently // using, and how much they need to be shrunk to keep the // total width (including the width of the imaginary item) // constant. let excess = this._summaryItemTitleWidth - expansion; let oldExcess = 0, shrinkage; if (excess) { for (let i = 0; i < this._summaryItems.length; i++) { if (this._summaryItems[i] != this._expandedSummaryItem) oldExcess += this._summaryItems[i].getTitleWidth(); } if (this._expandedSummaryItem) oldExcess += this._imaginarySummaryItemTitleWidth; } if (excess && oldExcess) shrinkage = excess / oldExcess; else shrinkage = 0; // Now shrink each one proportionately for (let i = 0; i < this._summaryItems.length; i++) { if (this._summaryItems[i] == this._expandedSummaryItem) continue; let width = this._summaryItems[i].getTitleWidth(); this._summaryItems[i].setTitleWidth(width * shrinkage); } if (this._expandedSummaryItem) this._imaginarySummaryItemTitleWidth *= shrinkage; }, _expandSummaryItemCompleted: function() { if (this._expandedSummaryItem) this._expandedSummaryItem.setEllipsization(Pango.EllipsizeMode.END); }, _onSummaryItemClicked: function(summaryItem) { if (!this._clickedSummaryItem || this._clickedSummaryItem != summaryItem) this._clickedSummaryItem = summaryItem; else this._clickedSummaryItem = null; this._updateState(); }, _onSummaryHoverChanged: function() { this._pointerInSummary = this._summary.hover; this._updateState(); }, _onTrayHoverChanged: function() { if (this.actor.hover) { // Don't do anything if the one pixel area at the bottom is hovered over while the tray is hidden. if (this._trayState == State.HIDDEN) return; // Don't do anything if this._useLongerTrayLeftTimeout is true, meaning the notification originally // popped up under the pointer, but this._trayLeftTimeoutId is 0, meaning the pointer didn't leave // the tray yet. We need to check for this case because sometimes _onTrayHoverChanged() gets called // multiple times while this.actor.hover is true. if (this._useLongerTrayLeftTimeout && !this._trayLeftTimeoutId) return; this._useLongerTrayLeftTimeout = false; if (this._trayLeftTimeoutId) { Mainloop.source_remove(this._trayLeftTimeoutId); this._trayLeftTimeoutId = 0; return; } if (this._showNotificationMouseX >= 0) { let actorAtShowNotificationPosition = global.stage.get_actor_at_pos(Clutter.PickMode.ALL, this._showNotificationMouseX, this._showNotificationMouseY); this._showNotificationMouseX = -1; this._showNotificationMouseY = -1; // Don't set this._pointerInTray to true if the pointer was initially in the area where the notification // popped up. That way we will not be expanding notifications that happen to pop up over the pointer // automatically. Instead, the user is able to expand the notification by mousing away from it and then // mousing back in. Because this is an expected action, we set the boolean flag that indicates that a longer // timeout should be used before popping down the notification. if (this._notificationBin.contains(actorAtShowNotificationPosition)) { this._useLongerTrayLeftTimeout = true; return; } } this._pointerInTray = true; this._updateState(); } else { // We wait just a little before hiding the message tray in case the user quickly moves the mouse back into it. // We wait for a longer period if the notification popped up where the mouse pointer was already positioned. // That gives the user more time to mouse away from the notification and mouse back in in order to expand it. let timeout = this._useLongerHideTimeout ? LONGER_HIDE_TIMEOUT * 1000 : HIDE_TIMEOUT * 1000; this._trayLeftTimeoutId = Mainloop.timeout_add(timeout, Lang.bind(this, this._onTrayLeftTimeout)); } }, _onTrayLeftTimeout: function() { this._useLongerTrayLeftTimeout = false; this._trayLeftTimeoutId = 0; this._pointerInTray = false; this._pointerInSummary = false; this._updateNotificationTimeout(0); this._updateState(); return false; }, escapeTray: function() { this.unlock(); this._pointerInTray = false; this._pointerInSummary = false; this._updateNotificationTimeout(0); this._updateState(); }, // All of the logic for what happens when occurs here; the various // event handlers merely update variables such as // 'this._pointerInTray', 'this._summaryState', etc, and // _updateState() figures out what (if anything) needs to be done // at the present time. _updateState: function() { // Notifications let notificationsPending = this._notificationQueue.length > 0; let notificationPinned = this._pointerInTray && !this._pointerInSummary && !this._notificationRemoved; let notificationExpanded = this._notificationBin.y < 0; let notificationExpired = (this._notificationTimeoutId == 0 && !this._pointerInTray && !this._locked) || this._notificationRemoved; if (this._notificationState == State.HIDDEN) { if (notificationsPending) this._showNotification(); } else if (this._notificationState == State.SHOWN) { if (notificationExpired) this._hideNotification(); else if (notificationPinned && !notificationExpanded) this._expandNotification(false); else if (notificationPinned) this._ensureNotificationFocused(); } // Summary let summarySummoned = this._pointerInSummary || this._overviewVisible; let summaryPinned = this._summaryTimeoutId != 0 || this._pointerInTray || summarySummoned || this._locked; let notificationsVisible = (this._notificationState == State.SHOWING || this._notificationState == State.SHOWN); let notificationsDone = !notificationsVisible && !notificationsPending; if (this._summaryState == State.HIDDEN) { if (notificationsDone && this._newSummaryItems.length > 0) this._showSummary(true); else if (summarySummoned) this._showSummary(false); } else if (this._summaryState == State.SHOWN) { if (!summaryPinned) this._hideSummary(); } // Summary notification let haveSummaryNotification = this._clickedSummaryItem != null; let summaryNotificationIsMainNotification = (haveSummaryNotification && this._clickedSummaryItem.source.notification == this._notification); let canShowSummaryNotification = this._summaryState == State.SHOWN; let wrongSummaryNotification = (haveSummaryNotification && this._summaryNotification != this._clickedSummaryItem.source.notification); if (this._summaryNotificationState == State.HIDDEN) { if (haveSummaryNotification && !summaryNotificationIsMainNotification && canShowSummaryNotification) this._showSummaryNotification(); } else if (this._summaryNotificationState == State.SHOWN) { if (!haveSummaryNotification || !canShowSummaryNotification || wrongSummaryNotification) this._hideSummaryNotification(); } // Tray itself let trayIsVisible = (this._trayState == State.SHOWING || this._trayState == State.SHOWN); let trayShouldBeVisible = (!notificationsDone || this._summaryState == State.SHOWING || this._summaryState == State.SHOWN); if (!trayIsVisible && trayShouldBeVisible) this._showTray(); else if (trayIsVisible && !trayShouldBeVisible) this._hideTray(); }, _tween: function(actor, statevar, value, params) { let onComplete = params.onComplete; let onCompleteScope = params.onCompleteScope; let onCompleteParams = params.onCompleteParams; params.onComplete = this._tweenComplete; params.onCompleteScope = this; params.onCompleteParams = [statevar, value, onComplete, onCompleteScope, onCompleteParams]; Tweener.addTween(actor, params); let valuing = (value == State.SHOWN) ? State.SHOWING : State.HIDING; this[statevar] = valuing; }, _tweenComplete: function(statevar, value, onComplete, onCompleteScope, onCompleteParams) { this[statevar] = value; if (onComplete) onComplete.apply(onCompleteScope, onCompleteParams); this._updateState(); }, _showTray: function() { let primary = global.get_primary_monitor(); this._tween(this.actor, '_trayState', State.SHOWN, { y: primary.y + primary.height - this.actor.height, time: ANIMATION_TIME, transition: 'easeOutQuad' }); }, _hideTray: function() { let primary = global.get_primary_monitor(); this._tween(this.actor, '_trayState', State.HIDDEN, { y: primary.y + primary.height - 1, time: ANIMATION_TIME, transition: 'easeOutQuad' }); }, _showNotification: function() { this._notification = this._notificationQueue.shift(); this._notificationBin.child = this._notification.actor; this._notificationBin.opacity = 0; this._notificationBin.y = this.actor.height; this._notificationBin.show(); this._updateShowingNotification(); let [x, y, mods] = global.get_pointer(); // We save the position of the mouse at the time when we started showing the notification // in order to determine if the notification popped up under it. We make that check if // the user starts moving the mouse and _onTrayHoverChanged() gets called. We don't // expand the notification if it just happened to pop up under the mouse unless the user // explicitly mouses away from it and then mouses back in. this._showNotificationMouseX = x; this._showNotificationMouseY = y; // We save the y coordinate of the mouse at the time when we started showing the notification // and then we update it in _notifiationTimeout() if the mouse is moving towards the // notification. We don't pop down the notification if the mouse is moving towards it. this._lastSeenMouseY = y; }, _updateShowingNotification: function() { Tweener.removeTweens(this._notificationBin); this._tween(this._notificationBin, '_notificationState', State.SHOWN, { y: 0, opacity: 255, time: ANIMATION_TIME, transition: 'easeOutQuad', onComplete: this._showNotificationCompleted, onCompleteScope: this }); // We auto-expand urgent notifications. // We call _expandNotification() again on the notifications that // are expanded in case they were in the process of hiding and need // to re-expand. if (this._notification.urgent || this._notification.expanded) // This will overwrite the y tween, but leave the opacity // tween, and so the onComplete will remain as well. this._expandNotification(true); }, _showNotificationCompleted: function() { this._updateNotificationTimeout(NOTIFICATION_TIMEOUT * 1000); }, _updateNotificationTimeout: function(timeout) { if (this._notificationTimeoutId) { Mainloop.source_remove(this._notificationTimeoutId); this._notificationTimeoutId = 0; } if (timeout > 0) this._notificationTimeoutId = Mainloop.timeout_add(timeout, Lang.bind(this, this._notificationTimeout)); }, _notificationTimeout: function() { let [x, y, mods] = global.get_pointer(); if (y > this._lastSeenMouseY + 10 && y < this.actor.y) { // The mouse is moving towards the notification, so don't // hide it yet. (We just create a new timeout (and destroy // the old one) each time because the bookkeeping is // simpler.) this._lastSeenMouseY = y; this._updateNotificationTimeout(1000); } else { this._notificationTimeoutId = 0; this._updateState(); } return false; }, _hideNotification: function() { this._notification.ungrabFocus(); if (this._notificationExpandedId) { this._notification.disconnect(this._notificationExpandedId); this._notificationExpandedId = 0; } this._tween(this._notificationBin, '_notificationState', State.HIDDEN, { y: this.actor.height, opacity: 0, time: ANIMATION_TIME, transition: 'easeOutQuad', onComplete: this._hideNotificationCompleted, onCompleteScope: this }); }, _hideNotificationCompleted: function() { this._notificationRemoved = false; this._notificationBin.hide(); this._notificationBin.child = null; this._notification.collapseCompleted(); this._notification = null; }, _expandNotification: function(autoExpanding) { // Don't grab focus in notifications that are auto-expanded. if (!autoExpanding) this._notification.grabFocus(false); if (!this._notificationExpandedId) this._notificationExpandedId = this._notification.connect('expanded', Lang.bind(this, this._onNotificationExpanded)); // Don't animate changes in notifications that are auto-expanding. this._notification.expand(!autoExpanding); }, _onNotificationExpanded: function() { let expandedY = this.actor.height - this._notificationBin.height; if (this._notificationBin.y != expandedY) this._tween(this._notificationBin, '_notificationState', State.SHOWN, { y: expandedY, time: ANIMATION_TIME, transition: 'easeOutQuad' }); }, // We use this function to grab focus when the user moves the pointer // to an urgent notification that was already auto-expanded. _ensureNotificationFocused: function() { this._notification.grabFocus(false); }, _showSummary: function(withTimeout) { let primary = global.get_primary_monitor(); this._summaryBin.opacity = 0; this._summaryBin.y = this.actor.height; this._tween(this._summaryBin, '_summaryState', State.SHOWN, { y: 0, opacity: 255, time: ANIMATION_TIME, transition: 'easeOutQuad', onComplete: this._showSummaryCompleted, onCompleteScope: this, onCompleteParams: [withTimeout] }); }, _showSummaryCompleted: function(withTimeout) { this._newSummaryItems = []; if (withTimeout) { this._summaryTimeoutId = Mainloop.timeout_add(SUMMARY_TIMEOUT * 1000, Lang.bind(this, this._summaryTimeout)); } }, _summaryTimeout: function() { this._summaryTimeoutId = 0; this._updateState(); return false; }, _hideSummary: function() { this._tween(this._summaryBin, '_summaryState', State.HIDDEN, { opacity: 0, time: ANIMATION_TIME, transition: 'easeOutQuad' }); this._newSummaryItems = []; }, _showSummaryNotification: function() { this._summaryNotification = this._clickedSummaryItem.source.notification; let index = this._notificationQueue.indexOf(this._summaryNotification); if (index != -1) this._notificationQueue.splice(index, 1); this._summaryNotificationBin.child = this._summaryNotification.actor; this._summaryNotification.grabFocus(true); this._summaryNotificationBin.opacity = 0; this._summaryNotificationBin.y = this.actor.height; this._summaryNotificationBin.show(); if (!this._summaryNotificationExpandedId) this._summaryNotificationExpandedId = this._summaryNotification.connect('expanded', Lang.bind(this, this._onSummaryNotificationExpanded)); this._summaryNotification.expand(false); }, _onSummaryNotificationExpanded: function() { this._tween(this._summaryNotificationBin, '_summaryNotificationState', State.SHOWN, { y: this.actor.height - this._summaryNotificationBin.height, opacity: 255, time: ANIMATION_TIME, transition: 'easeOutQuad' }); }, _hideSummaryNotification: function() { if (this._summaryNotificationExpandedId) { this._summaryNotification.disconnect(this._summaryNotificationExpandedId); this._summaryNotificationExpandedId = 0; } // Unset this._clickedSummaryItem if we are no longer showing the summary if (this._summaryState != State.SHOWN) this._clickedSummaryItem = null; this._summaryNotification.ungrabFocus(); this._tween(this._summaryNotificationBin, '_summaryNotificationState', State.HIDDEN, { y: this.actor.height, opacity: 0, time: ANIMATION_TIME, transition: 'easeOutQuad', onComplete: this._hideSummaryNotificationCompleted, onCompleteScope: this }); }, _hideSummaryNotificationCompleted: function() { this._summaryNotificationBin.hide(); this._summaryNotificationBin.child = null; this._summaryNotification.collapseCompleted(); let summaryNotification = this._summaryNotification; this._summaryNotification = null; if (this._reNotifyWithSummaryNotificationAfterHide) { this._onNotify(summaryNotification.source, summaryNotification); this._reNotifyWithSummaryNotificationAfterHide = false; } } };