Home | History | Annotate | Download | only in renderer 
      1 // Copyright 2013 The Chromium Authors. All rights reserved.
      2 // Use of this source code is governed by a BSD-style license that can be
      3 // found in the LICENSE file.
      4 
      5 #ifndef COMPONENTS_PLUGINS_RENDERER_WEBVIEW_PLUGIN_H_
      6 #define COMPONENTS_PLUGINS_RENDERER_WEBVIEW_PLUGIN_H_
      7 
      8 #include <list>
      9 
     10 #include "base/memory/scoped_ptr.h"
     11 #include "base/sequenced_task_runner_helpers.h"
     12 #include "third_party/WebKit/public/platform/WebCursorInfo.h"
     13 #include "third_party/WebKit/public/platform/WebString.h"
     14 #include "third_party/WebKit/public/platform/WebURLResponse.h"
     15 #include "third_party/WebKit/public/web/WebFrameClient.h"
     16 #include "third_party/WebKit/public/web/WebPlugin.h"
     17 #include "third_party/WebKit/public/web/WebViewClient.h"
     18 
     19 namespace blink {
     20 class WebMouseEvent;
     21 }
     22 
     23 namespace content {
     24 class RenderView;
     25 struct WebPreferences;
     26 }
     27 
     28 // This class implements the WebPlugin interface by forwarding drawing and
     29 // handling input events to a WebView.
     30 // It can be used as a placeholder for an actual plugin, using HTML for the UI.
     31 // To show HTML data inside the WebViewPlugin,
     32 // call web_view->mainFrame()->loadHTMLString() with the HTML data and a fake
     33 // chrome:// URL as origin.
     34 
     35 class WebViewPlugin : public blink::WebPlugin,
     36                       public blink::WebViewClient,
     37                       public blink::WebFrameClient {
     38  public:
     39   class Delegate {
     40    public:
     41     // Bind |frame| to a Javascript object, enabling the delegate to receive
     42     // callback methods from Javascript inside the WebFrame.
     43     // This method is called from WebFrameClient::didClearWindowObject.
     44     virtual void BindWebFrame(blink::WebFrame* frame) = 0;
     45 
     46     // Called upon a context menu event.
     47     virtual void ShowContextMenu(const blink::WebMouseEvent&) = 0;
     48 
     49     // Called when the WebViewPlugin is destroyed.
     50     virtual void PluginDestroyed() = 0;
     51   };
     52 
     53   // Convenience method to set up a new WebViewPlugin using |preferences|
     54   // and displaying |html_data|. |url| should be a (fake) chrome:// URL; it is
     55   // only used for navigation and never actually resolved.
     56   static WebViewPlugin* Create(Delegate* delegate,
     57                                const content::WebPreferences& preferences,
     58                                const std::string& html_data,
     59                                const GURL& url);
     60 
     61   blink::WebView* web_view() { return web_view_; }
     62 
     63   // When loading a plug-in document (i.e. a full page plug-in not embedded in
     64   // another page), we save all data that has been received, and replay it with
     65   // this method on the actual plug-in.
     66   void ReplayReceivedData(blink::WebPlugin* plugin);
     67 
     68   void RestoreTitleText();
     69 
     70   // WebPlugin methods:
     71   virtual blink::WebPluginContainer* container() const;
     72   virtual bool initialize(blink::WebPluginContainer*);
     73   virtual void destroy();
     74 
     75   virtual NPObject* scriptableObject();
     76   virtual struct _NPP* pluginNPP();
     77 
     78   virtual bool getFormValue(blink::WebString& value);
     79 
     80   virtual void paint(blink::WebCanvas* canvas, const blink::WebRect& rect);
     81 
     82   // Coordinates are relative to the containing window.
     83   virtual void updateGeometry(
     84       const blink::WebRect& frame_rect,
     85       const blink::WebRect& clip_rect,
     86       const blink::WebVector<blink::WebRect>& cut_out_rects,
     87       bool is_visible);
     88 
     89   virtual void updateFocus(bool);
     90   virtual void updateVisibility(bool) {}
     91 
     92   virtual bool acceptsInputEvents();
     93   virtual bool handleInputEvent(const blink::WebInputEvent& event,
     94                                 blink::WebCursorInfo& cursor_info);
     95 
     96   virtual void didReceiveResponse(const blink::WebURLResponse& response);
     97   virtual void didReceiveData(const char* data, int data_length);
     98   virtual void didFinishLoading();
     99   virtual void didFailLoading(const blink::WebURLError& error);
    100 
    101   // Called in response to WebPluginContainer::loadFrameRequest
    102   virtual void didFinishLoadingFrameRequest(const blink::WebURL& url,
    103                                             void* notifyData) {}
    104   virtual void didFailLoadingFrameRequest(const blink::WebURL& url,
    105                                           void* notify_data,
    106                                           const blink::WebURLError& error) {}
    107 
    108   // WebViewClient methods:
    109   virtual bool acceptsLoadDrops();
    110 
    111   virtual void setToolTipText(const blink::WebString&,
    112                               blink::WebTextDirection);
    113 
    114   virtual void startDragging(blink::WebLocalFrame* frame,
    115                              const blink::WebDragData& drag_data,
    116                              blink::WebDragOperationsMask mask,
    117                              const blink::WebImage& image,
    118                              const blink::WebPoint& point);
    119 
    120   // TODO(ojan): Remove this override and have this class use a non-null
    121   // layerTreeView.
    122   virtual bool allowsBrokenNullLayerTreeView() const;
    123 
    124   // WebWidgetClient methods:
    125   virtual void didInvalidateRect(const blink::WebRect&);
    126   virtual void didChangeCursor(const blink::WebCursorInfo& cursor);
    127   virtual void scheduleAnimation();
    128 
    129   // WebFrameClient methods:
    130   virtual void didClearWindowObject(blink::WebLocalFrame* frame);
    131 
    132   // This method is defined in WebPlugin as well as in WebFrameClient, but with
    133   // different parameters. We only care about implementing the WebPlugin
    134   // version, so we implement this method and call the default in WebFrameClient
    135   // (which does nothing) to correctly overload it.
    136   virtual void didReceiveResponse(blink::WebLocalFrame* frame,
    137                                   unsigned identifier,
    138                                   const blink::WebURLResponse& response);
    139 
    140  private:
    141   friend class base::DeleteHelper<WebViewPlugin>;
    142   WebViewPlugin(Delegate* delegate, const content::WebPreferences& preferences);
    143   virtual ~WebViewPlugin();
    144 
    145   // Manages its own lifetime.
    146   Delegate* delegate_;
    147 
    148   blink::WebCursorInfo current_cursor_;
    149 
    150   // Owns us.
    151   blink::WebPluginContainer* container_;
    152 
    153   // Owned by us, deleted via |close()|.
    154   blink::WebView* web_view_;
    155 
    156   // Owned by us, deleted via |close()|.
    157   blink::WebFrame* web_frame_;
    158   gfx::Rect rect_;
    159 
    160   blink::WebURLResponse response_;
    161   std::list<std::string> data_;
    162   bool finished_loading_;
    163   scoped_ptr<blink::WebURLError> error_;
    164   blink::WebString old_title_;
    165   bool focused_;
    166 };
    167 
    168 #endif  // COMPONENTS_PLUGINS_RENDERER_WEBVIEW_PLUGIN_H_
    169