Home | History | Annotate | Download | only in dom 
      1 /*
      2  * Copyright (C) 2013 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  *
      8  * 1. Redistributions of source code must retain the above copyright
      9  *    notice, this list of conditions and the following disclaimer.
     10  * 2. Redistributions in binary form must reproduce the above copyright
     11  *    notice, this list of conditions and the following disclaimer
     12  *    in the documentation and/or other materials provided with the
     13  *    distribution.
     14  * 3. Neither the name of Google Inc. nor the names of its contributors
     15  *    may be used to endorse or promote products derived from this
     16  *    software without specific prior written permission.
     17  *
     18  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     19  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     20  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
     21  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     22  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
     23  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
     24  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
     25  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
     26  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
     27  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
     28  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
     29  */
     30 
     31 #ifndef CustomElement_h
     32 #define CustomElement_h
     33 
     34 #include "core/dom/CustomElementDefinition.h"
     35 #include "wtf/HashMap.h"
     36 #include "wtf/Noncopyable.h"
     37 #include "wtf/PassRefPtr.h"
     38 #include "wtf/RefPtr.h"
     39 #include "wtf/Vector.h"
     40 #include "wtf/text/AtomicString.h"
     41 
     42 namespace WebCore {
     43 
     44 class Document;
     45 class Element;
     46 
     47 class CustomElement {
     48 public:
     49     enum NameSet {
     50         EmbedderNames = 1 << 0,
     51         StandardNames = 1 << 1,
     52         AllNames = EmbedderNames | StandardNames
     53     };
     54     static bool isValidName(const AtomicString& name, NameSet validNames = AllNames);
     55     static void addEmbedderCustomElementName(const AtomicString& name);
     56 
     57     // API for registration contexts
     58     static void define(Element*, PassRefPtr<CustomElementDefinition>);
     59 
     60     // API for wrapper creation, which uses a definition as a key
     61     static CustomElementDefinition* definitionFor(Element*);
     62 
     63     // API for Element to kick off changes
     64 
     65     static void attributeDidChange(Element*, const AtomicString& name, const AtomicString& oldValue, const AtomicString& newValue);
     66     static void didEnterDocument(Element*, Document*);
     67     static void didLeaveDocument(Element*, Document*);
     68     static void wasDestroyed(Element*);
     69 
     70 private:
     71     CustomElement();
     72 
     73     static Vector<AtomicString>& embedderCustomElementNames();
     74 
     75     // Maps resolved elements to their definitions
     76 
     77     class DefinitionMap {
     78         WTF_MAKE_NONCOPYABLE(DefinitionMap);
     79     public:
     80         DefinitionMap() { }
     81         ~DefinitionMap() { }
     82 
     83         void add(Element*, PassRefPtr<CustomElementDefinition>);
     84         void remove(Element*);
     85         CustomElementDefinition* get(Element*);
     86 
     87     private:
     88         typedef HashMap<Element*, RefPtr<CustomElementDefinition> > ElementDefinitionHashMap;
     89         ElementDefinitionHashMap m_definitions;
     90     };
     91     static DefinitionMap& definitions();
     92 };
     93 
     94 }
     95 
     96 #endif // CustomElement_h
     97