File: HTMLPlugInElement.h

package info (click to toggle)
chromium-browser 57.0.2987.98-1~deb8u1
  • links: PTS, VCS
  • area: main
  • in suites: jessie
  • size: 2,637,852 kB
  • ctags: 2,544,394
  • sloc: cpp: 12,815,961; ansic: 3,676,222; python: 1,147,112; asm: 526,608; java: 523,212; xml: 286,794; perl: 92,654; sh: 86,408; objc: 73,271; makefile: 27,698; cs: 18,487; yacc: 13,031; tcl: 12,957; pascal: 4,875; ml: 4,716; lex: 3,904; sql: 3,862; ruby: 1,982; lisp: 1,508; php: 1,368; exp: 404; awk: 325; csh: 117; jsp: 39; sed: 37
file content (192 lines) | stat: -rw-r--r-- 6,929 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
/*
 * Copyright (C) 1999 Lars Knoll (knoll@kde.org)
 *           (C) 1999 Antti Koivisto (koivisto@kde.org)
 * Copyright (C) 2004, 2006, 2007, 2008, 2009, 2012 Apple Inc. All rights
 * reserved.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public License
 * along with this library; see the file COPYING.LIB.  If not, write to
 * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
 * Boston, MA 02110-1301, USA.
 *
 */

#ifndef HTMLPlugInElement_h
#define HTMLPlugInElement_h

#include "bindings/core/v8/SharedPersistent.h"
#include "core/CoreExport.h"
#include "core/html/HTMLFrameOwnerElement.h"

#include <v8.h>

namespace blink {

class HTMLImageLoader;
class LayoutPart;
class LayoutEmbeddedItem;
class Widget;

enum PreferPlugInsForImagesOption {
  ShouldPreferPlugInsForImages,
  ShouldNotPreferPlugInsForImages
};

class CORE_EXPORT HTMLPlugInElement : public HTMLFrameOwnerElement {
 public:
  ~HTMLPlugInElement() override;
  DECLARE_VIRTUAL_TRACE();

  void resetInstance();
  // TODO(dcheng): Consider removing this, since HTMLEmbedElementLegacyCall
  // and HTMLObjectElementLegacyCall usage is extremely low.
  SharedPersistent<v8::Object>* pluginWrapper();
  Widget* pluginWidget() const;
  bool canProcessDrag() const;
  const String& url() const { return m_url; }

  // Public for FrameView::addPartToUpdate()
  bool needsWidgetUpdate() const { return m_needsWidgetUpdate; }
  void setNeedsWidgetUpdate(bool needsWidgetUpdate) {
    m_needsWidgetUpdate = needsWidgetUpdate;
  }
  void updateWidget();

  bool shouldAccelerate() const;

  void requestPluginCreationWithoutLayoutObjectIfPossible();
  void createPluginWithoutLayoutObject();

 protected:
  HTMLPlugInElement(const QualifiedName& tagName,
                    Document&,
                    bool createdByParser,
                    PreferPlugInsForImagesOption);

  // Node functions:
  void removedFrom(ContainerNode* insertionPoint) override;
  void didMoveToNewDocument(Document& oldDocument) override;

  // Element functions:
  bool isPresentationAttribute(const QualifiedName&) const override;
  void collectStyleForPresentationAttribute(const QualifiedName&,
                                            const AtomicString&,
                                            MutableStylePropertySet*) override;

  virtual bool hasFallbackContent() const;
  virtual bool useFallbackContent() const;
  // Create or update the LayoutPart and return it, triggering layout if
  // necessary.
  virtual LayoutPart* layoutPartForJSBindings() const;

  bool isImageType();
  bool shouldPreferPlugInsForImages() const {
    return m_shouldPreferPlugInsForImages;
  }
  LayoutEmbeddedItem layoutEmbeddedItem() const;
  bool allowedToLoadFrameURL(const String& url);
  bool requestObject(const String& url,
                     const String& mimeType,
                     const Vector<String>& paramNames,
                     const Vector<String>& paramValues);
  bool shouldUsePlugin(const KURL&,
                       const String& mimeType,
                       bool hasFallback,
                       bool& useFallback);

  void dispatchErrorEvent();
  void lazyReattachIfNeeded();

  String m_serviceType;
  String m_url;
  KURL m_loadedUrl;
  Member<HTMLImageLoader> m_imageLoader;
  bool m_isDelayingLoadEvent;

 private:
  // EventTarget overrides:
  void removeAllEventListeners() final;

  // Node overrides:
  bool canContainRangeEndPoint() const override { return false; }
  bool canStartSelection() const override;
  bool willRespondToMouseClickEvents() final;
  void defaultEventHandler(Event*) final;
  void attachLayoutTree(const AttachContext& = AttachContext()) final;
  void detachLayoutTree(const AttachContext& = AttachContext()) final;
  void finishParsingChildren() final;

  // Element overrides:
  LayoutObject* createLayoutObject(const ComputedStyle&) override;
  bool supportsFocus() const final { return true; }
  bool layoutObjectIsFocusable() const final;
  bool isKeyboardFocusable() const final;
  void didAddUserAgentShadowRoot(ShadowRoot&) final;

  // HTMLElement overrides:
  bool hasCustomFocusLogic() const override;
  bool isPluginElement() const final;

  // HTMLFrameOwnerElement overrides:
  void disconnectContentFrame() override;

  // Return any existing LayoutPart without triggering relayout, or 0 if it
  // doesn't yet exist.
  virtual LayoutPart* existingLayoutPart() const = 0;
  virtual void updateWidgetInternal() = 0;

  bool loadPlugin(const KURL&,
                  const String& mimeType,
                  const Vector<String>& paramNames,
                  const Vector<String>& paramValues,
                  bool useFallback,
                  bool requireLayoutObject);
  // Perform checks after we have determined that a plugin will be used to
  // show the object (i.e after allowedToLoadObject).
  bool allowedToLoadPlugin(const KURL&, const String& mimeType);
  // Perform checks based on the URL and MIME-type of the object to load.
  bool allowedToLoadObject(const KURL&, const String& mimeType);
  bool wouldLoadAsNetscapePlugin(const String& url, const String& serviceType);

  void setPersistedPluginWidget(Widget*);

  bool requestObjectInternal(const String& url,
                             const String& mimeType,
                             const Vector<String>& paramNames,
                             const Vector<String>& paramValues);

  mutable RefPtr<SharedPersistent<v8::Object>> m_pluginWrapper;
  bool m_needsWidgetUpdate;
  bool m_shouldPreferPlugInsForImages;
  // Represents |layoutObject() && layoutObject()->isEmbeddedObject() &&
  // !layoutEmbeddedItem().showsUnavailablePluginIndicator()|.  We want to
  // avoid accessing |layoutObject()| in layoutObjectIsFocusable().
  bool m_pluginIsAvailable = false;

  // Normally the Widget is stored in HTMLFrameOwnerElement::m_widget.
  // However, plugins can persist even when not rendered. In order to
  // prevent confusing code which may assume that widget() != null
  // means the frame is active, we save off m_widget here while
  // the plugin is persisting but not being displayed.
  Member<Widget> m_persistedPluginWidget;
};

inline bool isHTMLPlugInElement(const HTMLElement& element) {
  return element.isPluginElement();
}

DEFINE_HTMLELEMENT_TYPE_CASTS_WITH_FUNCTION(HTMLPlugInElement);

}  // namespace blink

#endif  // HTMLPlugInElement_h