6af67086da33d9df1b07928d7a6a2ff7aa406e27
[WebKit-https.git] / WebCore / khtml / xml / dom_nodeimpl.h
1 /*
2  * This file is part of the DOM implementation for KDE.
3  *
4  * Copyright (C) 1999 Lars Knoll (knoll@kde.org)
5  *           (C) 1999 Antti Koivisto (koivisto@kde.org)
6  *           (C) 2001 Dirk Mueller (mueller@kde.org)
7  * Copyright (C) 2004 Apple Computer, Inc.
8  *
9  * This library is free software; you can redistribute it and/or
10  * modify it under the terms of the GNU Library General Public
11  * License as published by the Free Software Foundation; either
12  * version 2 of the License, or (at your option) any later version.
13  *
14  * This library is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
17  * Library General Public License for more details.
18  *
19  * You should have received a copy of the GNU Library General Public License
20  * along with this library; see the file COPYING.LIB.  If not, write to
21  * the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
22  * Boston, MA 02111-1307, USA.
23  *
24  */
25 #ifndef _DOM_NodeImpl_h_
26 #define _DOM_NodeImpl_h_
27
28 #include "dom/dom_misc.h"
29 #include "dom/dom_string.h"
30 #include "dom/dom_node.h"
31 #include "misc/helper.h"
32 #include "misc/shared.h"
33 #include "dom_atomicstring.h"
34
35 class QPainter;
36 template <class type> class QPtrList;
37 class KHTMLView;
38 class RenderArena;
39 class QRect;
40 class QMouseEvent;
41 class QKeyEvent;
42 class QTextStream;
43 class QStringList;
44
45 namespace khtml {
46     class RenderObject;
47     class RenderStyle;
48 };
49
50 namespace DOM {
51
52 class CSSStyleDeclarationImpl;
53 class DocumentImpl;
54 class ElementImpl;
55 class EventImpl;
56 class NamedNodeMapImpl;
57 class NodeListImpl;
58 class Position;
59 class Range;
60 class RangeImpl;
61 class RegisteredEventListener;
62
63 // The namespace used for XHTML elements
64 #define XHTML_NAMESPACE "http://www.w3.org/1999/xhtml"
65
66 const Q_UINT16 noNamespace = 0;
67 const Q_UINT16 anyNamespace = 1;
68 const Q_UINT16 xhtmlNamespace = 2;
69 const Q_UINT16 anyLocalName = 0;
70
71 const Q_UINT32 namespaceMask = 0xFFFF0000U;
72 const Q_UINT32 localNameMask = 0x0000FFFFU;
73
74 inline Q_UINT16 namespacePart(Q_UINT32 i) { return i >> 16; }
75 inline Q_UINT16 localNamePart(Q_UINT32 i) { return i; }
76 inline Q_UINT32 makeId(Q_UINT16 n, Q_UINT16 l) { return (n << 16) | l; }
77
78 const Q_UINT32 anyQName = makeId(anyNamespace, anyLocalName);
79
80 class DocumentPtr : public khtml::Shared<DocumentPtr>
81 {
82 public:
83     DocumentImpl *document() const { return doc; }
84 private:
85     DocumentPtr() { doc = 0; }
86     friend class DocumentImpl;
87     friend class DOMImplementationImpl;
88
89     DocumentImpl *doc;
90 };
91
92 // this class implements nodes, which can have a parent but no children:
93 class NodeImpl : public khtml::TreeShared<NodeImpl>
94 {
95     friend class DocumentImpl;
96 public:
97     NodeImpl(DocumentPtr *doc);
98     virtual ~NodeImpl();
99
100     // DOM methods & attributes for Node
101     virtual DOMString nodeName() const;
102     virtual DOMString nodeValue() const;
103     virtual void setNodeValue( const DOMString &_nodeValue, int &exceptioncode );
104     virtual unsigned short nodeType() const;
105     NodeImpl *parentNode() const { return m_parent; }
106     NodeImpl *previousSibling() const { return m_previous; }
107     NodeImpl *nextSibling() const { return m_next; }
108     virtual NodeListImpl *childNodes();
109     virtual NodeImpl *firstChild() const;
110     virtual NodeImpl *lastChild() const;
111     virtual NodeImpl *insertBefore ( NodeImpl *newChild, NodeImpl *refChild, int &exceptioncode );
112     virtual NodeImpl *replaceChild ( NodeImpl *newChild, NodeImpl *oldChild, int &exceptioncode );
113     virtual NodeImpl *removeChild ( NodeImpl *oldChild, int &exceptioncode );
114     virtual NodeImpl *appendChild ( NodeImpl *newChild, int &exceptioncode );
115     virtual void remove(int &exceptioncode);
116     virtual bool hasChildNodes (  ) const;
117     virtual NodeImpl *cloneNode ( bool deep ) = 0;
118     virtual DOMString localName() const;
119     virtual DOMString prefix() const;
120     virtual void setPrefix(const DOMString &_prefix, int &exceptioncode );
121     void normalize ();
122
123     // Other methods (not part of DOM)
124     virtual bool isElementNode() const { return false; }
125     virtual bool isHTMLElement() const { return false; }
126     virtual bool isAttributeNode() const { return false; }
127     virtual bool isTextNode() const { return false; }
128     virtual bool isDocumentNode() const { return false; }
129     virtual bool isXMLElementNode() const { return false; }
130     bool isBlockFlow() const;
131     
132     // Used by <form> elements to indicate a malformed state of some kind, typically
133     // used to keep from applying the bottom margin of the form.
134     virtual bool isMalformed() { return false; }
135     virtual void setMalformed(bool malformed) {};
136     
137     virtual bool containsOnlyWhitespace() const { return false; }
138     
139     // helper functions not being part of the DOM
140     // Attention: they assume that the caller did the consistency checking!
141     void setPreviousSibling(NodeImpl *previous) { m_previous = previous; }
142     void setNextSibling(NodeImpl *next) { m_next = next; }
143
144     virtual void setFirstChild(NodeImpl *child);
145     virtual void setLastChild(NodeImpl *child);
146
147     bool isAtomicNode() const;
148     NodeImpl *previousNodeConsideringAtomicNodes() const;
149     NodeImpl *nextNodeConsideringAtomicNodes() const;
150     
151     /** (Not part of the official DOM)
152      * Returns the next leaf node.
153      *
154      * Using this function delivers leaf nodes as if the whole DOM tree
155      * were a linear chain of its leaf nodes.
156      * @return next leaf node or 0 if there are no more.
157      */
158     NodeImpl *nextLeafNode() const;
159
160     /** (Not part of the official DOM)
161      * Returns the previous leaf node.
162      *
163      * Using this function delivers leaf nodes as if the whole DOM tree
164      * were a linear chain of its leaf nodes.
165      * @return previous leaf node or 0 if there are no more.
166      */
167     NodeImpl *previousLeafNode() const;
168
169     bool isEditableBlock() const;
170     ElementImpl *enclosingBlockFlowElement() const;
171     ElementImpl *rootEditableElement() const;
172     
173     bool inSameRootEditableElement(NodeImpl *);
174     bool inSameContainingBlockFlowElement(NodeImpl *);
175     
176     Position positionForCoordinates(int x, int y);
177
178     // used by the parser. Doesn't do as many error checkings as
179     // appendChild(), and returns the node into which will be parsed next.
180     virtual NodeImpl *addChild(NodeImpl *newChild);
181
182     typedef Q_UINT32 Id;
183     // id() is used to easily and exactly identify a node. It
184     // is optimized for quick comparison and low memory consumption.
185     // its value depends on the owner document of the node and is
186     // categorized in the following way:
187     // 1..ID_LAST_TAG: the node inherits HTMLElementImpl and is
188     //                 part of the HTML namespace.
189     //                 The HTML namespace is either the global
190     //                 one (no namespace) or the XHTML namespace
191     //                 depending on the owner document's doctype
192     // ID_LAST_TAG+1..0xffff: non-HTML elements in the global namespace
193     // others       non-HTML elements in a namespace.
194     //                 the upper 16 bit identify the namespace
195     //                 the lower 16 bit identify the local part of the
196     //                 qualified element name.
197     virtual Id id() const { return 0; };
198 #if APPLE_CHANGES
199     Id identifier() const;
200 #endif
201     enum MouseEventType {
202         MousePress,
203         MouseRelease,
204         MouseClick,
205         MouseDblClick,
206         MouseMove
207     };
208
209     struct MouseEvent
210     {
211         MouseEvent( int _button, MouseEventType _type,
212                     const DOMString &_url = DOMString(), const DOMString& _target = DOMString(),
213                     NodeImpl *_innerNode = 0)
214             {
215                 button = _button; type = _type;
216                 url = _url; target = _target;
217                 innerNode = _innerNode;
218             }
219
220         int button;
221         MouseEventType type;
222         DOMString url; // url under mouse or empty
223         DOMString target;
224         Node innerNode;
225     };
226
227     // for LINK and STYLE
228     virtual void sheetLoaded() {}
229
230     bool hasID() const      { return m_hasId; }
231     bool hasClass() const   { return m_hasClass; }
232     bool hasStyle() const   { return m_hasStyle; }
233     bool active() const     { return m_active; }
234     bool focused() const { return m_focused; }
235     bool attached() const   { return m_attached; }
236     bool changed() const    { return m_changed; }
237     bool hasChangedChild() const { return m_hasChangedChild; }
238     bool hasAnchor() const { return m_hasAnchor; }
239     bool inDocument() const { return m_inDocument; }
240     bool styleElement() const { return m_styleElement; }
241     bool implicitNode() const { return m_implicit; }
242     void setHasID(bool b=true) { m_hasId = b; }
243     void setHasClass(bool b=true) { m_hasClass = b; }
244     void setHasStyle(bool b=true) { m_hasStyle = b; }
245     void setHasChangedChild( bool b = true ) { m_hasChangedChild = b; }
246     void setInDocument(bool b=true) { m_inDocument = b; }
247     virtual void setFocus(bool b=true) { m_focused = b; }
248     virtual void setActive(bool b=true) { m_active = b; }
249     void setChanged(bool b=true);
250
251     unsigned short tabIndex() const { return m_tabIndex; }
252     void setTabIndex(unsigned short _tabIndex) { m_tabIndex = _tabIndex; }
253
254     /**
255         * whether this node can receive the keyboard focus.
256      */
257     virtual bool isFocusable() const;
258     virtual bool isKeyboardFocusable() const;
259     virtual bool isMouseFocusable() const;
260     
261     virtual bool isInline() const;
262     virtual QString toHTML() const;
263     QString recursive_toHTML(bool onlyIncludeChildren=false, const DOM::RangeImpl *range=NULL, QPtrList<NodeImpl> *nodes=NULL) const;
264     void recursive_completeURLs(QString baseURL);
265     
266     virtual bool isContentEditable() const;
267     virtual QRect getRect() const;
268
269     enum StyleChange { NoChange, NoInherit, Inherit, Detach, Force };
270     virtual void recalcStyle( StyleChange = NoChange ) {}
271     StyleChange diff( khtml::RenderStyle *s1, khtml::RenderStyle *s2 ) const;
272
273     unsigned long nodeIndex() const;
274     // Returns the document that this node is associated with. This is guaranteed to always be non-null, as opposed to
275     // DOM's ownerDocument() which is null for Document nodes (and sometimes DocumentType nodes).
276     DocumentImpl* getDocument() const { return document->document(); }
277
278     void setDocument(DocumentPtr *doc);
279
280     void addEventListener(int id, EventListener *listener, const bool useCapture);
281     void removeEventListener(int id, EventListener *listener, bool useCapture);
282     void removeHTMLEventListener(int id);
283     void setHTMLEventListener(int id, EventListener *listener);
284     EventListener *getHTMLEventListener(int id);
285
286     bool dispatchEvent(EventImpl *evt, int &exceptioncode, bool tempEvent = false);
287     bool dispatchGenericEvent( EventImpl *evt, int &exceptioncode);
288     bool dispatchHTMLEvent(int _id, bool canBubbleArg, bool cancelableArg);
289     bool dispatchWindowEvent(int _id, bool canBubbleArg, bool cancelableArg);
290     bool dispatchMouseEvent(QMouseEvent *e, int overrideId = 0, int overrideDetail = 0);
291     bool dispatchUIEvent(int _id, int detail = 0);
292     bool dispatchSubtreeModifiedEvent();
293     bool dispatchKeyEvent(QKeyEvent *key);
294
295     void handleLocalEvents(EventImpl *evt, bool useCapture);
296
297     /**
298      * Perform the default action for an event e.g. submitting a form
299      */
300     virtual void defaultEventHandler(EventImpl *evt);
301
302     /**
303      * Used for disabled form elements; if true, prevents mouse events from being dispatched
304      * to event listeners, and prevents DOMActivate events from being sent at all.
305      */
306     virtual bool disabled() const;
307
308     virtual bool isReadOnly();
309     virtual bool childTypeAllowed( unsigned short /*type*/ ) { return false; }
310     virtual unsigned long childNodeCount() const;
311     virtual NodeImpl *childNode(unsigned long index);
312
313     /**
314      * Does a pre-order traversal of the tree to find the node next node after this one. This uses the same order that
315      * the tags appear in the source file.
316      *
317      * @param stayWithin If not null, the traversal will stop once the specified node is reached. This can be used to
318      * restrict traversal to a particular sub-tree.
319      *
320      * @return The next node, in document order
321      *
322      * see @ref traversePreviousNode()
323      */
324     NodeImpl *traverseNextNode(NodeImpl *stayWithin = 0) const;
325     
326     /* Like traverseNextNode, but skips children and starts with the next sibling. */
327     NodeImpl *traverseNextSibling(NodeImpl *stayWithin = 0) const;
328
329     /**
330      * Does a reverse pre-order traversal to find the node that comes before the current one in document order
331      *
332      * see @ref traverseNextNode()
333      */
334     NodeImpl *traversePreviousNode() const;
335
336     DocumentPtr *docPtr() const { return document; }
337
338     NodeImpl *previousEditable() const;
339     NodeImpl *nextEditable() const;
340     //bool isEditable() const;
341
342     khtml::RenderObject *renderer() const { return m_render; }
343     khtml::RenderObject *nextRenderer();
344     khtml::RenderObject *previousRenderer();
345     void setRenderer(khtml::RenderObject* renderer) { m_render = renderer; }
346     
347     void checkSetPrefix(const DOMString &_prefix, int &exceptioncode);
348     void checkAddChild(NodeImpl *newChild, int &exceptioncode);
349     bool isAncestor(const NodeImpl *) const;
350     virtual bool childAllowed( NodeImpl *newChild );
351
352     virtual long maxOffset() const;
353     virtual long caretMinOffset() const;
354     virtual long caretMaxOffset() const;
355     virtual unsigned long caretMaxRenderedOffset() const;
356
357 #ifndef NDEBUG
358     virtual void dump(QTextStream *stream, QString ind = "") const;
359 #endif
360
361     // -----------------------------------------------------------------------------
362     // Integration with rendering tree
363
364     /**
365      * Attaches this node to the rendering tree. This calculates the style to be applied to the node and creates an
366      * appropriate RenderObject which will be inserted into the tree (except when the style has display: none). This
367      * makes the node visible in the KHTMLView.
368      */
369     virtual void attach();
370
371     /**
372      * Detaches the node from the rendering tree, making it invisible in the rendered view. This method will remove
373      * the node's rendering object from the rendering tree and delete it.
374      */
375     virtual void detach();
376
377     void createRendererIfNeeded();
378     virtual khtml::RenderStyle *styleForRenderer(khtml::RenderObject *parent);
379     virtual bool rendererIsNeeded(khtml::RenderStyle *);
380     virtual khtml::RenderObject *createRenderer(RenderArena *, khtml::RenderStyle *);
381
382     // -----------------------------------------------------------------------------
383     // Methods for maintaining the state of the element between history navigation
384
385     /**
386      * Indicates whether or not this type of node maintains it's state. If so, the state of the node will be stored when
387      * the user goes to a different page using the state() method, and restored using the restoreState() method if the
388      * user returns (e.g. using the back button). This is used to ensure that user-changeable elements such as form
389      * controls maintain their contents when the user returns to a previous page in the history.
390      */
391     virtual bool maintainsState();
392
393     /**
394      * Returns the state of this node represented as a string. This string will be passed to restoreState() if the user
395      * returns to the page.
396      *
397      * @return State information about the node represented as a string
398      */
399     virtual QString state();
400
401     /**
402      * Sets the state of the element based on strings previously returned by state(). This is used to initialize form
403      * controls with their old values when the user returns to the page in their history.  The receiver
404      * should remove the string from the list that it uses for its restore.
405      *
406      * @param states The strings previously returned by nodes' state methods.
407      */
408     virtual void restoreState(QStringList &stateList);
409
410     // -----------------------------------------------------------------------------
411     // Notification of document stucture changes
412
413     /**
414      * Notifies the node that it has been inserted into the document. This is called during document parsing, and also
415      * when a node is added through the DOM methods insertBefore(), appendChild() or replaceChild(). Note that this only
416      * happens when the node becomes part of the document tree, i.e. only when the document is actually an ancestor of
417      * the node. The call happens _after_ the node has been added to the tree.
418      *
419      * This is similar to the DOMNodeInsertedIntoDocument DOM event, but does not require the overhead of event
420      * dispatching.
421      */
422     virtual void insertedIntoDocument();
423
424     /**
425      * Notifies the node that it is no longer part of the document tree, i.e. when the document is no longer an ancestor
426      * node.
427      *
428      * This is similar to the DOMNodeRemovedFromDocument DOM event, but does not require the overhead of event
429      * dispatching, and is called _after_ the node is removed from the tree.
430      */
431     virtual void removedFromDocument();
432
433     /**
434      * Notifies the node that it's list of children have changed (either by adding or removing child nodes), or a child
435      * node that is of the type CDATA_SECTION_NODE, TEXT_NODE or COMMENT_NODE has changed it's value.
436      */
437     virtual void childrenChanged();
438
439     virtual DOMString toString() const = 0;
440     
441 #ifndef NDEBUG
442     virtual void formatForDebugger(char *buffer, unsigned length) const;
443 #endif
444
445 private: // members
446     DocumentPtr *document;
447     NodeImpl *m_previous;
448     NodeImpl *m_next;
449 protected:
450     khtml::RenderObject *m_render;
451     QPtrList<RegisteredEventListener> *m_regdListeners;
452
453     unsigned short m_tabIndex : 15;
454     bool m_hasTabIndex  : 1;
455
456     bool m_hasId : 1;
457     bool m_hasClass : 1;
458     bool m_hasStyle : 1;
459     bool m_attached : 1;
460     bool m_changed : 1;
461     bool m_hasChangedChild : 1;
462     bool m_inDocument : 1;
463
464     bool m_hasAnchor : 1;
465     bool m_specified : 1; // used in AttrImpl. Accessor functions there
466     bool m_focused : 1;
467     bool m_active : 1;
468     bool m_styleElement : 1; // contains stylesheet text
469     bool m_implicit : 1; // implicitely generated by the parser
470
471     // 3 bits unused
472 };
473
474 // this is the full Node Implementation with parents and children.
475 class NodeBaseImpl : public NodeImpl
476 {
477 public:
478     NodeBaseImpl(DocumentPtr *doc);
479     virtual ~NodeBaseImpl();
480
481     // DOM methods overridden from  parent classes
482     virtual NodeImpl *firstChild() const;
483     virtual NodeImpl *lastChild() const;
484     virtual NodeImpl *insertBefore ( NodeImpl *newChild, NodeImpl *refChild, int &exceptioncode );
485     virtual NodeImpl *replaceChild ( NodeImpl *newChild, NodeImpl *oldChild, int &exceptioncode );
486     virtual NodeImpl *removeChild ( NodeImpl *oldChild, int &exceptioncode );
487     virtual NodeImpl *appendChild ( NodeImpl *newChild, int &exceptioncode );
488     virtual bool hasChildNodes (  ) const;
489
490     // Other methods (not part of DOM)
491     void removeChildren();
492     void cloneChildNodes(NodeImpl *clone);
493
494     virtual void setFirstChild(NodeImpl *child);
495     virtual void setLastChild(NodeImpl *child);
496     virtual NodeImpl *addChild(NodeImpl *newChild);
497     virtual void attach();
498     virtual void detach();
499
500     virtual NodeListImpl *getElementsByTagNameNS ( DOMStringImpl* namespaceURI,
501                                                    DOMStringImpl* localName );
502
503     virtual QRect getRect() const;
504     bool getUpperLeftCorner(int &xPos, int &yPos) const;
505     bool getLowerRightCorner(int &xPos, int &yPos) const;
506
507     virtual void setFocus(bool=true);
508     virtual void setActive(bool=true);
509     virtual unsigned long childNodeCount() const;
510     virtual NodeImpl *childNode(unsigned long index);
511
512     virtual void insertedIntoDocument();
513     virtual void removedFromDocument();
514     
515     // check for being (grand-..)father:
516     bool checkNoOwner( NodeImpl *other, int &exceptioncode );
517
518 //protected:
519     NodeImpl *_first;
520     NodeImpl *_last;
521
522     // helper functions for inserting children:
523
524     // ### this should vanish. do it in dom/ !
525     // check for same source document:
526     bool checkSameDocument( NodeImpl *newchild, int &exceptioncode );
527     // check for being child:
528     bool checkIsChild( NodeImpl *oldchild, int &exceptioncode );
529     // ###
530
531     // find out if a node is allowed to be our child
532     void dispatchChildInsertedEvents( NodeImpl *child, int &exceptioncode );
533     void dispatchChildRemovalEvents( NodeImpl *child, int &exceptioncode );
534 };
535
536 // --------------------------------------------------------------------------
537 class Node;
538 class NodeImpl;
539
540 class NodeListImpl : public khtml::Shared<NodeListImpl>
541 {
542 public:
543     virtual ~NodeListImpl() {}
544
545     // DOM methods & attributes for NodeList
546     virtual unsigned long length() const;
547     virtual NodeImpl *item ( unsigned long index ) const;
548
549     // Other methods (not part of DOM)
550
551 #if APPLE_CHANGES
552     static NodeList createInstance(NodeListImpl *impl);
553 #endif
554 protected:
555     // helper functions for searching all ElementImpls in a tree
556     unsigned long recursiveLength(NodeImpl *start) const;
557     NodeImpl *recursiveItem ( NodeImpl *start, unsigned long &offset ) const;
558     virtual bool nodeMatches( NodeImpl *testNode ) const = 0;
559 };
560
561 class ChildNodeListImpl : public NodeListImpl
562 {
563 public:
564     ChildNodeListImpl( NodeImpl *n);
565     virtual ~ChildNodeListImpl();
566
567     // DOM methods overridden from  parent classes
568
569     virtual unsigned long length() const;
570     virtual NodeImpl *item ( unsigned long index ) const;
571
572 protected:
573     virtual bool nodeMatches( NodeImpl *testNode ) const;
574
575     NodeImpl *refNode;
576 };
577
578
579 /**
580  * NodeList which lists all Nodes in a document with a given tag name
581  */
582 class TagNodeListImpl : public NodeListImpl
583 {
584 public:
585     TagNodeListImpl( NodeImpl *n, NodeImpl::Id tagId, NodeImpl::Id tagIdMask );
586     virtual ~TagNodeListImpl();
587
588     // DOM methods overridden from  parent classes
589
590     virtual unsigned long length() const;
591     virtual NodeImpl *item ( unsigned long index ) const;
592
593     // Other methods (not part of DOM)
594
595 protected:
596     virtual bool nodeMatches( NodeImpl *testNode ) const;
597
598     NodeImpl *refNode;
599     NodeImpl::Id m_id;
600     NodeImpl::Id m_idMask;
601 };
602
603
604 /**
605  * NodeList which lists all Nodes in a Element with a given "name=" tag
606  */
607 class NameNodeListImpl : public NodeListImpl
608 {
609 public:
610     NameNodeListImpl( NodeImpl *doc, const DOMString &t );
611     virtual ~NameNodeListImpl();
612
613     // DOM methods overridden from  parent classes
614
615     virtual unsigned long length() const;
616     virtual NodeImpl *item ( unsigned long index ) const;
617
618     // Other methods (not part of DOM)
619
620 protected:
621     virtual bool nodeMatches( NodeImpl *testNode ) const;
622
623     NodeImpl *refNode;
624     DOMString nodeName;
625 };
626
627
628 // Generic NamedNodeMap interface
629 // Other classes implement this for more specific situations e.g. attributes
630 // of an element
631 class NamedNodeMapImpl : public khtml::Shared<NamedNodeMapImpl>
632 {
633 public:
634     NamedNodeMapImpl();
635     virtual ~NamedNodeMapImpl();
636
637     // DOM methods & attributes for NamedNodeMap
638     virtual NodeImpl *getNamedItem ( NodeImpl::Id id ) const = 0;
639     virtual Node removeNamedItem ( NodeImpl::Id id, int &exceptioncode ) = 0;
640     virtual Node setNamedItem ( NodeImpl* arg, int &exceptioncode ) = 0;
641
642     virtual NodeImpl *item ( unsigned long index ) const = 0;
643     virtual unsigned long length(  ) const = 0;
644
645     // Other methods (not part of DOM)
646     virtual NodeImpl::Id mapId(const DOMString& namespaceURI,  const DOMString& localName,  bool readonly) = 0;
647     virtual bool isReadOnly() { return false; }
648
649 #if APPLE_CHANGES
650     static NamedNodeMap createInstance(NamedNodeMapImpl *impl);
651 #endif
652 };
653
654
655 // ### fixme
656 #if 0
657 // Generic read-only NamedNodeMap implementation
658 // You can add items using the internal function addItem()
659 class GenericRONamedNodeMapImpl : public NamedNodeMapImpl
660 {
661 public:
662     GenericRONamedNodeMapImpl(DocumentPtr* doc);
663     virtual ~GenericRONamedNodeMapImpl();
664
665     // DOM methods & attributes for NamedNodeMap
666
667     virtual NodeImpl *getNamedItem ( const DOMString &name, int &exceptioncode ) const;
668     virtual Node setNamedItem ( const Node &arg, int &exceptioncode );
669     virtual Node removeNamedItem ( const DOMString &name, int &exceptioncode );
670     virtual NodeImpl *item ( unsigned long index ) const;
671     virtual unsigned long length(  ) const;
672     virtual NodeImpl *getNamedItemNS( const DOMString &namespaceURI, const DOMString &localName,
673                                       int &exceptioncode ) const;
674     virtual NodeImpl *setNamedItemNS( NodeImpl *arg, int &exceptioncode );
675     virtual NodeImpl *removeNamedItemNS( const DOMString &namespaceURI, const DOMString &localName,
676                                          int &exceptioncode );
677
678     // Other methods (not part of DOM)
679
680     virtual bool isReadOnly() { return true; }
681
682     void addNode(NodeImpl *n);
683
684 protected:
685     DocumentImpl* m_doc;
686     QPtrList<NodeImpl> *m_contents;
687 };
688 #endif
689
690 }; //namespace
691 #endif