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';
@@ skipping 18 matching lines @@
 
     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.promoMessage_ = $('other-sessions-promo-message');
+
       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 contents to the default state.
+     * @private
+     */
+    resetMenuContents_: function() {

[Dan Beam, 2012/03/27 18:09:21]

thank you for renaming this, beat me to it

+      this.menu.innerHTML = '';
+      this.menu.appendChild(this.promoMessage_);
+    },
+
+    /**
      * 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) {

[Evan Stade, 2012/03/27 18:20:20]

can you do this with css instead? something like:

* ~ promo-message-id {
  display: none;
}

[Patrick Dubroy, 2012/03/27 20:06:19]

Nice idea. Doesn't quite work but your second suggestion, using :only-child,
does.

+      this.promoMessage_.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.resetMenuContents_();
+      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]);
+        }
+      }

[Evan Stade, 2012/03/27 18:20:20]

\n

[Patrick Dubroy, 2012/03/27 20:06:19]

Done.

+      // 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]);
-      }
-
-      if (sessionList.length == 0)
+    /**
+     * Called when this element is initialized, and 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) {
+      if (signedIn)
+        chrome.send('getForeignSessions');
+      else
         this.classList.add('invisible');
-      else
-        this.classList.remove('invisible');
-
-      this.sessions_ = sessionList;
     },
   };
 
   return {
     OtherSessionsMenuButton: OtherSessionsMenuButton,
   };
 });