third_party/WebKit/Source/core/dom/CharacterData.h

   1 /*
   2  * Copyright (C) 1999 Lars Knoll (knoll@kde.org)
   3  *           (C) 1999 Antti Koivisto (koivisto@kde.org)
   4  * Copyright (C) 2003, 2004, 2005, 2006, 2008, 2009 Apple Inc. All rights reserved.
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Library General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Library General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Library General Public License
  17  * along with this library; see the file COPYING.LIB.  If not, write to
  18  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  19  * Boston, MA 02110-1301, USA.
  20  *
  21  */
  22
  23 #ifndef CharacterData_h
  24 #define CharacterData_h
  25
  26 #include "core/CoreExport.h"
  27 #include "core/dom/Node.h"
  28 #include "wtf/text/WTFString.h"
  29
  30 namespace blink {
  31
  32 class ExceptionState;
  33
  34 class CORE_EXPORT CharacterData : public Node {
  35     DEFINE_WRAPPERTYPEINFO();
  36 public:
  37     void atomize();
  38     const String& data() const { return m_data; }
  39     void setData(const String&);
  40     unsigned length() const { return m_data.length(); }
  41     String substringData(unsigned offset, unsigned count, ExceptionState&);
  42     void appendData(const String&);
  43     void replaceData(unsigned offset, unsigned count, const String&, ExceptionState&);
  44
  45     enum RecalcStyleBehavior { DoNotRecalcStyle, DeprecatedRecalcStyleImmediatlelyForEditing };
  46     void insertData(unsigned offset, const String&, ExceptionState&, RecalcStyleBehavior = DoNotRecalcStyle);
  47     void deleteData(unsigned offset, unsigned count, ExceptionState&, RecalcStyleBehavior = DoNotRecalcStyle);
  48
  49     bool containsOnlyWhitespace() const;
  50
  51     StringImpl* dataImpl() { return m_data.impl(); }
  52
  53     void parserAppendData(const String&);
  54
  55 protected:
  56     CharacterData(TreeScope& treeScope, const String& text, ConstructionType type)
  57         : Node(&treeScope, type)
  58         , m_data(!text.isNull() ? text : emptyString())
  59     {
  60         ASSERT(type == CreateOther || type == CreateText || type == CreateEditingText);
  61     }
  62
  63     void setDataWithoutUpdate(const String& data)
  64     {
  65         ASSERT(!data.isNull());
  66         m_data = data;
  67     }
  68     enum UpdateSource {
  69         UpdateFromParser,
  70         UpdateFromNonParser,
  71     };
  72     void didModifyData(const String& oldValue, UpdateSource);
  73
  74     String m_data;
  75
  76 private:
  77     String nodeValue() const final;
  78     void setNodeValue(const String&) final;
  79     bool isCharacterDataNode() const final { return true; }
  80     int maxCharacterOffset() const final;
  81     void setDataAndUpdate(const String&, unsigned offsetOfReplacedData, unsigned oldLength, unsigned newLength, UpdateSource = UpdateFromNonParser, RecalcStyleBehavior = DoNotRecalcStyle);
  82
  83     bool isContainerNode() const = delete; // This will catch anyone doing an unnecessary check.
  84     bool isElementNode() const = delete; // This will catch anyone doing an unnecessary check.
  85 };
  86
  87 DEFINE_NODE_TYPE_CASTS(CharacterData, isCharacterDataNode());
  88
  89 } // namespace blink
  90
  91 #endif // CharacterData_h