Add a sign-in promo message to the Other Devices menu.

chrome/browser/resources/ntp4/other_sessions.js

 // 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.
 
 /**
  * @fileoverview The menu that shows tabs from sessions on other devices.
  */
 
 cr.define('ntp', function() {
   'use strict';
 
   var localStrings = new LocalStrings();
   var Menu = cr.ui.Menu;
   var MenuItem = cr.ui.MenuItem;
   var MenuButton = cr.ui.MenuButton;
   var OtherSessionsMenuButton = cr.ui.define('button');
 
   // Histogram buckets for UMA tracking of menu usage.
   var HISTOGRAM_EVENT = {
       INITIALIZED: 0,
       SHOW_MENU: 1,
       LINK_CLICKED: 2,
       LINK_RIGHT_CLICKED: 3
   };
   var HISTOGRAM_EVENT_LIMIT = HISTOGRAM_EVENT.LINK_RIGHT_CLICKED + 1;
 
+  // Indicates whether or not the current user is signed in. This is
+  // initially set in initialize(), and is updated when the user's login state
+  // changes.
+  var isUserSignedIn = false;

[Dan Beam, 2012/03/26 23:18:54]

nit: this is probably meant to go on the class prototype so it's instance
specific, but this doesn't seem pressing...

[Patrick Dubroy, 2012/03/27 00:36:51]

Actually, it's not even used anymore.

+
   OtherSessionsMenuButton.prototype = {
     __proto__: MenuButton.prototype,
 
     decorate: function() {
       MenuButton.prototype.decorate.call(this);
       this.menu = new Menu;
       cr.ui.decorate(this.menu, Menu);
       this.menu.classList.add('footer-menu');
       this.menu.addEventListener('contextmenu',
                                  this.onContextMenu_.bind(this), true);
       document.body.appendChild(this.menu);
 
+      this.resetMenu_();
+
       this.sessions_ = [];
       this.anchorType = cr.ui.AnchorType.ABOVE;
       this.invertLeftRight = true;
 
-      chrome.send('getForeignSessions');
       this.recordUmaEvent_(HISTOGRAM_EVENT.INITIALIZED);
     },
 
     /**
+     * Initialize this element.
+     * @param {boolean} signedIn Is the current user signed in?
+     */
+    initialize: function(signedIn) {
+      this.updateSignInState(signedIn);
+    },
+
+    /**
      * Record an event in the UMA histogram.
      * @param {Number} eventId The id of the event to be recorded.
      */
     recordUmaEvent_: function(eventId) {
       chrome.send('metricsHandler:recordInHistogram',
           ['NewTabPage.OtherSessionsMenu', eventId, HISTOGRAM_EVENT_LIMIT]);
     },
 
     /**
      * Handle a context menu event for an object in the menu's DOM subtree.
@@ skipping 11 matching lines @@
      * @override
      */
     showMenu: function() {
       if (this.sessions_.length == 0)
         chrome.send('getForeignSessions');
       this.recordUmaEvent_(HISTOGRAM_EVENT.SHOW_MENU);
       MenuButton.prototype.showMenu.call(this);
     },
 
     /**
+     * Reset the menu to the default state.
+     * @private
+     */
+    resetMenu_: function() {
+      var promoContent = $('other-sessions-promo-message');

[Dan Beam, 2012/03/26 23:18:54]

why do you need to do

  var promoContent = $('other-sessions-promo-message');

isn't |this| already the same thing?

[Patrick Dubroy, 2012/03/26 23:46:07]

No, 'this' is the button that you click to show the menu. The promo message is
the content that gets put in the menu under certain conditions.

[Dan Beam, 2012/03/27 00:03:42]

Then it seems like you should be assigning this to a private or protected member
on initialization (and possibly passing it to initialize()).

[Patrick Dubroy, 2012/03/27 00:36:51]

Done.

+      this.menu.innerHTML = '';
+      this.menu.appendChild(promoContent);
+      promoContent.hidden = true;
+    },
+
+    /**
      * Create a custom click handler for a link, so that clicking on a link
      * restores the session (including back stack) rather than just opening
      * the URL.
      */
     makeClickHandler_: function(sessionTag, windowId, tabId) {
       var self = this;
       return function(e) {
         self.recordUmaEvent_(HISTOGRAM_EVENT.LINK_CLICKED);
         chrome.send('openForeignSession', [sessionTag, windowId, tabId,
             e.button, e.altKey, e.ctrlKey, e.metaKey, e.shiftKey]);
@@ skipping 26 matching lines @@
           a.style.backgroundImage = 'url(chrome://favicon/' + tab.url + ')';
           var clickHandler = this.makeClickHandler_(
               session.tag, String(window.sessionId), String(tab.sessionId));
           a.addEventListener('click', clickHandler);
           section.appendChild(a);
         }
       }
     },
 
     /**
-     * Create the UI for the promo and place it inside the menu.
-     * The promo is shown instead of foreign session data when tab sync is
-     * not enabled for a profile.
+     * Show or hide the promo message shown in place of the session list.
+     * The promo is shown when the user is signed in, but there is no foreign
+     * session data available.
+     * @param {boolean} visible Whether the message should be shown.
+     * @private
      */
-    showPromo_: function() {
-      var message = localStrings.getString('otherSessionsEmpty');
-      this.menu.appendChild(this.ownerDocument.createTextNode(message));
+    setPromoVisible_: function(visible) {
+      this.resetMenu_();
+      $('other-sessions-promo-message').hidden = !visible;
     },
 
     /**
-     * Sets the menu model data.
+     * Sets the menu model data. An empty list means that either there are no
+     * foreign sessions, or tab sync is disabled for this profile.
+     * |isTabSyncEnabled| makes it possible to distinguish between the cases.
+     *
      * @param {Array} sessionList Array of objects describing the sessions
-     * from other devices.
+     *     from other devices.
+     * @param {boolean} isTabSyncEnabled Is tab sync enabled for this profile?
      */
-    set sessions(sessionList) {
-      // Clear the current contents of the menu.
-      this.menu.innerHTML = '';
+    setForeignSessions: function(sessionList, isTabSyncEnabled) {
+      this.sessions_ = sessionList;
+      this.setPromoVisible_(sessionList.length == 0);
+      if (sessionList.length > 0) {
+        // Rebuild the menu with the new data.
+        for (var i = 0; i < sessionList.length; i++) {
+          this.addSession_(sessionList[i]);
+        }
+      }
+      // The menu button is shown iff tab sync is enabled.
+      if (isTabSyncEnabled)
+        this.classList.remove('invisible');
+      else
+        this.classList.add('invisible');
+    },
 
-      // Rebuild the menu with the new data.
-      for (var i = 0; i < sessionList.length; i++) {
-        this.addSession_(sessionList[i]);
-      }
+    /**
+     * Called from the new tab page when the user's signed in state changes.
+     * @param {boolean} signedIn Is the user currently signed in?
+     */
+    updateSignInState: function(signedIn) {
+      isUserSignedIn = signedIn;
 
-      if (sessionList.length == 0)
+      if (signedIn)
+        chrome.send('getForeignSessions');
+      else
         this.classList.add('invisible');
-      else
-        this.classList.remove('invisible');
-
-      this.sessions_ = sessionList;
     },
   };
 
   return {
     OtherSessionsMenuButton: OtherSessionsMenuButton,
   };
 });