src/third_party/WebKit/Source/core/inspector/InspectorCSSAgent.h

   1 /*
   2  * Copyright (C) 2010, Google Inc. All rights reserved.
   3  *
   4  * Redistribution and use in source and binary forms, with or without
   5  * modification, are permitted provided that the following conditions
   6  * are met:
   7  * 1.  Redistributions of source code must retain the above copyright
   8  *     notice, this list of conditions and the following disclaimer.
   9  * 2.  Redistributions in binary form must reproduce the above copyright
  10  *     notice, this list of conditions and the following disclaimer in the
  11  *     documentation and/or other materials provided with the distribution.
  12  *
  13  * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS'' AND ANY
  14  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  15  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  16  * DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY
  17  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  18  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  19  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
  20  * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  21  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  22  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  23  */
  24
  25 #ifndef InspectorCSSAgent_h
  26 #define InspectorCSSAgent_h
  27
  28 #include "core/css/CSSSelector.h"
  29 #include "core/dom/SecurityContext.h"
  30 #include "core/frame/ContentSecurityPolicy.h"
  31 #include "core/inspector/InspectorBaseAgent.h"
  32 #include "core/inspector/InspectorDOMAgent.h"
  33 #include "core/inspector/InspectorStyleSheet.h"
  34 #include "platform/JSONValues.h"
  35 #include "wtf/HashCountedSet.h"
  36 #include "wtf/HashMap.h"
  37 #include "wtf/HashSet.h"
  38 #include "wtf/PassRefPtr.h"
  39 #include "wtf/RefPtr.h"
  40 #include "wtf/Vector.h"
  41 #include "wtf/text/WTFString.h"
  42
  43 namespace WebCore {
  44
  45 struct CSSParserString;
  46 class CSSRule;
  47 class CSSRuleList;
  48 class CSSStyleRule;
  49 class CSSStyleSheet;
  50 class Document;
  51 class Element;
  52 class InspectorFrontend;
  53 class InspectorResourceAgent;
  54 class InstrumentingAgents;
  55 class MediaList;
  56 class Node;
  57 class NodeList;
  58 class PlatformFontUsage;
  59 class RenderText;
  60 class StyleResolver;
  61
  62 class InspectorCSSAgent FINAL
  63     : public InspectorBaseAgent<InspectorCSSAgent>
  64     , public InspectorDOMAgent::DOMListener
  65     , public InspectorBackendDispatcher::CSSCommandHandler
  66     , public InspectorStyleSheet::Listener {
  67     WTF_MAKE_NONCOPYABLE(InspectorCSSAgent);
  68 public:
  69     enum MediaListSource {
  70         MediaListSourceLinkedSheet,
  71         MediaListSourceInlineSheet,
  72         MediaListSourceMediaRule,
  73         MediaListSourceImportRule
  74     };
  75
  76     enum StyleSheetsUpdateType {
  77         InitialFrontendLoad = 0,
  78         ExistingFrontendRefresh,
  79     };
  80
  81     class InlineStyleOverrideScope {
  82     public:
  83         InlineStyleOverrideScope(SecurityContext* context)
  84             : m_contentSecurityPolicy(context->contentSecurityPolicy())
  85         {
  86             m_contentSecurityPolicy->setOverrideAllowInlineStyle(true);
  87         }
  88
  89         ~InlineStyleOverrideScope()
  90         {
  91             m_contentSecurityPolicy->setOverrideAllowInlineStyle(false);
  92         }
  93
  94     private:
  95         ContentSecurityPolicy* m_contentSecurityPolicy;
  96     };
  97
  98     static CSSStyleRule* asCSSStyleRule(CSSRule*);
  99
 100     static PassOwnPtr<InspectorCSSAgent> create(InspectorDOMAgent* domAgent, InspectorPageAgent* pageAgent, InspectorResourceAgent* resourceAgent)
 101     {
 102         return adoptPtr(new InspectorCSSAgent(domAgent, pageAgent, resourceAgent));
 103     }
 104     virtual ~InspectorCSSAgent();
 105
 106     bool forcePseudoState(Element*, CSSSelector::PseudoType);
 107     virtual void setFrontend(InspectorFrontend*) OVERRIDE;
 108     virtual void clearFrontend() OVERRIDE;
 109     virtual void discardAgent() OVERRIDE;
 110     virtual void restore() OVERRIDE;
 111     virtual void enable(ErrorString*, PassRefPtr<EnableCallback>) OVERRIDE;
 112     virtual void disable(ErrorString*) OVERRIDE;
 113     void reset();
 114     void didCommitLoad(Frame*, DocumentLoader*);
 115     void mediaQueryResultChanged();
 116     void willMutateRules();
 117     void didMutateRules(CSSStyleSheet*);
 118     void willMutateStyle();
 119     void didMutateStyle(CSSStyleDeclaration*, bool);
 120
 121 public:
 122     void activeStyleSheetsUpdated(Document*);
 123     void frameDetachedFromParent(Frame*);
 124
 125     virtual void getComputedStyleForNode(ErrorString*, int nodeId, RefPtr<TypeBuilder::Array<TypeBuilder::CSS::CSSComputedStyleProperty> >&) OVERRIDE;
 126     virtual void getPlatformFontsForNode(ErrorString*, int nodeId, String* cssFamilyName, RefPtr<TypeBuilder::Array<TypeBuilder::CSS::PlatformFontUsage> >&) OVERRIDE;
 127     virtual void getInlineStylesForNode(ErrorString*, int nodeId, RefPtr<TypeBuilder::CSS::CSSStyle>& inlineStyle, RefPtr<TypeBuilder::CSS::CSSStyle>& attributes) OVERRIDE;
 128     virtual void getMatchedStylesForNode(ErrorString*, int nodeId, const bool* includePseudo, const bool* includeInherited, RefPtr<TypeBuilder::Array<TypeBuilder::CSS::RuleMatch> >& matchedCSSRules, RefPtr<TypeBuilder::Array<TypeBuilder::CSS::PseudoIdMatches> >&, RefPtr<TypeBuilder::Array<TypeBuilder::CSS::InheritedStyleEntry> >& inheritedEntries) OVERRIDE;
 129     virtual void getStyleSheet(ErrorString*, const String& styleSheetId, RefPtr<TypeBuilder::CSS::CSSStyleSheetBody>& result) OVERRIDE;
 130     virtual void getStyleSheetText(ErrorString*, const String& styleSheetId, String* result) OVERRIDE;
 131     virtual void setStyleSheetText(ErrorString*, const String& styleSheetId, const String& text) OVERRIDE;
 132     virtual void setPropertyText(ErrorString*, const RefPtr<JSONObject>& styleId, int propertyIndex, const String& text, bool overwrite, RefPtr<TypeBuilder::CSS::CSSStyle>& result) OVERRIDE;
 133     virtual void setRuleSelector(ErrorString*, const RefPtr<JSONObject>& ruleId, const String& selector, RefPtr<TypeBuilder::CSS::CSSRule>& result) OVERRIDE;
 134     virtual void addRule(ErrorString*, int contextNodeId, const String& selector, RefPtr<TypeBuilder::CSS::CSSRule>& result) OVERRIDE;
 135     virtual void forcePseudoState(ErrorString*, int nodeId, const RefPtr<JSONArray>& forcedPseudoClasses) OVERRIDE;
 136
 137     PassRefPtr<TypeBuilder::CSS::CSSMedia> buildMediaObject(const MediaList*, MediaListSource, const String&, CSSStyleSheet*);
 138     PassRefPtr<TypeBuilder::Array<TypeBuilder::CSS::CSSMedia> > buildMediaListChain(CSSRule*);
 139
 140 private:
 141     class StyleSheetAction;
 142     class SetStyleSheetTextAction;
 143     class SetPropertyTextAction;
 144     class SetRuleSelectorAction;
 145     class AddRuleAction;
 146     class EnableResourceClient;
 147
 148     InspectorCSSAgent(InspectorDOMAgent*, InspectorPageAgent*, InspectorResourceAgent*);
 149
 150     typedef HashMap<String, RefPtr<InspectorStyleSheet> > IdToInspectorStyleSheet;
 151     typedef HashMap<Node*, RefPtr<InspectorStyleSheetForInlineStyle> > NodeToInspectorStyleSheet; // bogus "stylesheets" with elements' inline styles
 152     typedef HashMap<int, unsigned> NodeIdToForcedPseudoState;
 153
 154     void wasEnabled(PassRefPtr<EnableCallback>);
 155     void resetNonPersistentData();
 156     InspectorStyleSheetForInlineStyle* asInspectorStyleSheet(Element* element);
 157     Element* elementForId(ErrorString*, int nodeId);
 158     void collectAllStyleSheets(Vector<InspectorStyleSheet*>&);
 159     void collectAllDocumentStyleSheets(Document*, Vector<CSSStyleSheet*>&);
 160     void collectStyleSheets(CSSStyleSheet*, Vector<CSSStyleSheet*>&);
 161
 162     void updateActiveStyleSheetsForDocument(Document*, StyleSheetsUpdateType);
 163     void updateActiveStyleSheets(Frame*, const Vector<CSSStyleSheet*>&, StyleSheetsUpdateType);
 164
 165     void collectPlatformFontsForRenderer(RenderText*, HashCountedSet<String>*);
 166
 167     InspectorStyleSheet* bindStyleSheet(CSSStyleSheet*);
 168     String unbindStyleSheet(InspectorStyleSheet*);
 169     InspectorStyleSheet* viaInspectorStyleSheet(Document*, bool createIfAbsent);
 170     InspectorStyleSheet* assertStyleSheetForId(ErrorString*, const String&);
 171     TypeBuilder::CSS::StyleSheetOrigin::Enum detectOrigin(CSSStyleSheet* pageStyleSheet, Document* ownerDocument);
 172     bool styleSheetEditInProgress() const { return m_styleSheetsPendingMutation || m_styleDeclarationPendingMutation || m_isSettingStyleSheetText; }
 173
 174     PassRefPtr<TypeBuilder::CSS::CSSRule> buildObjectForRule(CSSStyleRule*);
 175     PassRefPtr<TypeBuilder::Array<TypeBuilder::CSS::CSSRule> > buildArrayForRuleList(CSSRuleList*);
 176     PassRefPtr<TypeBuilder::Array<TypeBuilder::CSS::RuleMatch> > buildArrayForMatchedRuleList(CSSRuleList*, Element*);
 177     PassRefPtr<TypeBuilder::CSS::CSSStyle> buildObjectForAttributesStyle(Element*);
 178
 179     // InspectorDOMAgent::DOMListener implementation
 180     virtual void didRemoveDocument(Document*) OVERRIDE;
 181     virtual void didRemoveDOMNode(Node*) OVERRIDE;
 182     virtual void didModifyDOMAttr(Element*) OVERRIDE;
 183
 184     // InspectorStyleSheet::Listener implementation
 185     virtual void styleSheetChanged(InspectorStyleSheet*) OVERRIDE;
 186     virtual void willReparseStyleSheet() OVERRIDE;
 187     virtual void didReparseStyleSheet() OVERRIDE;
 188
 189     void resetPseudoStates();
 190
 191     InspectorFrontend::CSS* m_frontend;
 192     InspectorDOMAgent* m_domAgent;
 193     InspectorPageAgent* m_pageAgent;
 194     InspectorResourceAgent* m_resourceAgent;
 195
 196     IdToInspectorStyleSheet m_idToInspectorStyleSheet;
 197     HashMap<CSSStyleSheet*, RefPtr<InspectorStyleSheet> > m_cssStyleSheetToInspectorStyleSheet;
 198     HashMap<Frame*, OwnPtr<HashSet<CSSStyleSheet*> > > m_frameToCSSStyleSheets;
 199
 200     NodeToInspectorStyleSheet m_nodeToInspectorStyleSheet;
 201     HashMap<RefPtr<Document>, RefPtr<InspectorStyleSheet> > m_documentToViaInspectorStyleSheet; // "via inspector" stylesheets
 202     NodeIdToForcedPseudoState m_nodeIdToForcedPseudoState;
 203
 204     RefPtr<CSSStyleSheet> m_inspectorUserAgentStyleSheet;
 205
 206     int m_lastStyleSheetId;
 207     int m_styleSheetsPendingMutation;
 208     bool m_styleDeclarationPendingMutation;
 209     bool m_creatingViaInspectorStyleSheet;
 210     bool m_isSettingStyleSheetText;
 211
 212     friend class EnableResourceClient;
 213     friend class StyleSheetBinder;
 214 };
 215
 216
 217 } // namespace WebCore
 218
 219 #endif // !defined(InspectorCSSAgent_h)