Source/WebCore/css/CSSValueList.h

   1 /*
   2  * (C) 1999-2003 Lars Knoll (knoll@kde.org)
   3  * Copyright (C) 2004, 2005, 2006, 2007, 2008, 2009, 2010 Apple Inc. All rights reserved.
   4  *
   5  * This library is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU Library General Public
   7  * License as published by the Free Software Foundation; either
   8  * version 2 of the License, or (at your option) any later version.
   9  *
  10  * This library is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13  * Library General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU Library General Public License
  16  * along with this library; see the file COPYING.LIB.  If not, write to
  17  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  18  * Boston, MA 02110-1301, USA.
  19  */
  20
  21 #ifndef CSSValueList_h
  22 #define CSSValueList_h
  23
  24 #include "CSSValue.h"
  25 #include <wtf/PassRefPtr.h>
  26 #include <wtf/Vector.h>
  27
  28 namespace WebCore {
  29
  30 class CSSParserValueList;
  31
  32 class CSSValueList : public CSSValue {
  33 public:
  34     static PassRefPtr<CSSValueList> createCommaSeparated()
  35     {
  36         return adoptRef(new CSSValueList(CommaSeparator));
  37     }
  38     static PassRefPtr<CSSValueList> createSpaceSeparated()
  39     {
  40         return adoptRef(new CSSValueList(SpaceSeparator));
  41     }
  42     static PassRefPtr<CSSValueList> createSlashSeparated()
  43     {
  44         return adoptRef(new CSSValueList(SlashSeparator));
  45     }
  46     static PassRefPtr<CSSValueList> createFromParserValueList(CSSParserValueList* list)
  47     {
  48         return adoptRef(new CSSValueList(list));
  49     }
  50
  51     size_t length() const { return m_values.size(); }
  52     CSSValue* item(size_t index) { return index < m_values.size() ? m_values[index].get() : 0; }
  53     CSSValue* itemWithoutBoundsCheck(size_t index) { return m_values[index].get(); }
  54
  55     void append(PassRefPtr<CSSValue>);
  56     void prepend(PassRefPtr<CSSValue>);
  57     bool removeAll(CSSValue*);
  58     bool hasValue(CSSValue*) const;
  59     PassRefPtr<CSSValueList> copy();
  60
  61     String customCssText() const;
  62 #if ENABLE(CSS_VARIABLES)
  63     String customSerializeResolvingVariables(const HashMap<AtomicString, String>&) const;
  64 #endif
  65
  66     void addSubresourceStyleURLs(ListHashSet<KURL>&, const StyleSheetContents*) const;
  67
  68     PassRefPtr<CSSValueList> cloneForCSSOM() const;
  69
  70 protected:
  71     CSSValueList(ClassType, ValueListSeparator);
  72     CSSValueList(const CSSValueList& cloneFrom);
  73
  74 private:
  75     explicit CSSValueList(ValueListSeparator);
  76     explicit CSSValueList(CSSParserValueList*);
  77
  78     Vector<RefPtr<CSSValue> > m_values;
  79 };
  80
  81 // Objects of this class are intended to be stack-allocated and scoped to a single function.
  82 // Please take care not to pass these around as they do hold onto a raw pointer.
  83 class CSSValueListInspector {
  84 public:
  85     CSSValueListInspector(CSSValue* value) : m_list((value && value->isValueList()) ? static_cast<CSSValueList*>(value) : 0) { }
  86     CSSValue* item(size_t index) const { ASSERT(index < length()); return m_list->itemWithoutBoundsCheck(index); }
  87     CSSValue* first() const { return item(0); }
  88     CSSValue* second() const { return item(1); }
  89     size_t length() const { return m_list ? m_list->length() : 0; }
  90 private:
  91     CSSValueList* m_list;
  92 };
  93
  94 // Wrapper that can be used to iterate over any CSSValue. Non-list values and 0 behave as zero-length lists.
  95 // Objects of this class are intended to be stack-allocated and scoped to a single function.
  96 // Please take care not to pass these around as they do hold onto a raw pointer.
  97 class CSSValueListIterator {
  98 public:
  99     CSSValueListIterator(CSSValue* value) : m_inspector(value), m_position(0) { }
 100     bool hasMore() const { return m_position < m_inspector.length(); }
 101     CSSValue* value() const { return m_inspector.item(m_position); }
 102     bool isPrimitiveValue() const { return value()->isPrimitiveValue(); }
 103     void advance() { m_position++; ASSERT(m_position <= m_inspector.length());}
 104     size_t index() const { return m_position; }
 105 private:
 106     CSSValueListInspector m_inspector;
 107     size_t m_position;
 108 };
 109 } // namespace WebCore
 110
 111 #endif // CSSValueList_h