[WebModals] New API for browser-scoped popup management.

components/web_modal/single_popup_manager.h

+// Copyright 2014 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 COMPONENTS_WEB_MODAL_SINGLE_POPUP_MANAGER_H_
+#define COMPONENTS_WEB_MODAL_SINGLE_POPUP_MANAGER_H_
+
+#include "components/web_modal/native_web_contents_modal_dialog.h"
+
+namespace content {
+class WebContents;
+}
+
+namespace web_modal {
+
+// Interface from SinglePopupManager to PopupManager.
+class SinglePopupManagerDelegate {
+ public:
+  SinglePopupManagerDelegate() {}
+  virtual ~SinglePopupManagerDelegate() {}
+
+  // Notify the delegate that the dialog is closing. The
+  // calling SinglePopupManager will be deleted before the end of this call.
+  virtual void WillClose(NativePopup popup) = 0;
+
+ private:
+  DISALLOW_COPY_AND_ASSIGN(SinglePopupManagerDelegate);
+};
+
+// Provides an interface for platform-specific UI implementation for popups.
+// Each object will manage a single NativePopup window during its lifecycle.
+// The rule of thumb is that only one popup will be shown at a time per tab.
+// (Exceptions exist.)
+//
+// Implementation classes should accept a NativePopup at construction time
+// and register to be notified when the dialog is closing, so that it can
+// notify its delegate (WillClose method).
+class SinglePopupManager {
+ public:
+  virtual ~SinglePopupManager() {}
+
+  // If the manager returns non-null to this call, it is bound to a particular
+  // tab and will be hidden and shown if that tab visibility changes.
+  virtual content::WebContents* GetBoundWebContents() = 0;
+
+  // Makes the popup visible.
+  virtual void Show() = 0;
+
+  // Hides the popup without closing it.
+  virtual void Hide() = 0;
+
+  // Closes the popup.
+  // This method must call WillClose() on the delegate.
+  // Important note: this object will be deleted at the close of that
+  // invocation.
+  virtual void Close() = 0;
+
+  // Sets focus on the popup.
+  virtual void Focus() = 0;
+
+  virtual void Pulse() = 0;
+
+  // Returns the popup under management by this object.
+  virtual NativePopup popup() = 0;
+
+  // Returns true if the popup under management was initiated by a user
+  // gesture. When this is true, the popup manager will hide any existing
+  // popups and move the newly-created NativePopup to the top of the display
+  // queue.
+  virtual bool HasUserGesture() = 0;
+
+  // Returns true if the popup under management is tolerant of being overlapped
+  // by other popups. This may be true for large web-modals which cover most of
+  // the window real estate (e.g. print preview).
+  virtual bool MayBeOverlapped() = 0;
+
+  // Returns true if the popup under management should close if there is a
+  // navigation underneath it, including the showing of any interstitial
+  // content. Popups which relate to the web content being displayed will
+  // ordinarily set this to true.
+  virtual bool ShouldCloseOnNavigation() = 0;

[Mike Wittman, 2014/05/23 19:02:35]

It would be good to eventually generalize this to support the same-origin logic
that's currently in WebContentsModalDialogManager::DidNavigateMainFrame, and
push that down to a dialog-specific configuration.

[Greg Billock, 2014/05/27 22:42:03]

Yeah, I think that's right. Do you know what other knobs we need to parameterize
that? I put a TODO in the file, but if you know the answer we can add it right
now. :-)

[Mike Wittman, 2014/05/28 21:47:09]

The cases I'm aware of that result in closing the dialog are: attaching an
interstitial page, navigating to a page not on the same domain, and navigating
to any other page. The latter two cases should be covered by a
content::LoadCommittedDetails or even just previous and current URLs. I don't
know that we have any similar state on attaching an interstitial page.

+
+ protected:
+  SinglePopupManager() {}
+
+ private:
+  DISALLOW_COPY_AND_ASSIGN(SinglePopupManager);
+};
+
+}  // namespace web_modal
+
+#endif  // COMPONENTS_WEB_MODAL_SINGLE_POPUP_MANAGER_H_