diff options
| author | Matt A. Tobin <mattatobin@localhost.localdomain> | 2018-02-02 04:16:08 -0500 |
|---|---|---|
| committer | Matt A. Tobin <mattatobin@localhost.localdomain> | 2018-02-02 04:16:08 -0500 |
| commit | 5f8de423f190bbb79a62f804151bc24824fa32d8 (patch) | |
| tree | 10027f336435511475e392454359edea8e25895d /parser/htmlparser/nsIHTMLContentSink.h | |
| parent | 49ee0794b5d912db1f95dce6eb52d781dc210db5 (diff) | |
| download | UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar.gz UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar.lz UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar.xz UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.zip | |
Add m-esr52 at 52.6.0
Diffstat (limited to 'parser/htmlparser/nsIHTMLContentSink.h')
| -rw-r--r-- | parser/htmlparser/nsIHTMLContentSink.h | 89 |
1 files changed, 89 insertions, 0 deletions
diff --git a/parser/htmlparser/nsIHTMLContentSink.h b/parser/htmlparser/nsIHTMLContentSink.h new file mode 100644 index 000000000..bf08c4b5e --- /dev/null +++ b/parser/htmlparser/nsIHTMLContentSink.h @@ -0,0 +1,89 @@ +/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ +/* This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ +#ifndef nsIHTMLContentSink_h___ +#define nsIHTMLContentSink_h___ + +/** + * This interface is OBSOLETE and in the process of being REMOVED. + * Do NOT implement! + * + * This file declares the concrete HTMLContentSink class. + * This class is used during the parsing process as the + * primary interface between the parser and the content + * model. + * + * After the tokenizer completes, the parser iterates over + * the known token list. As the parser identifies valid + * elements, it calls the contentsink interface to notify + * the content model that a new node or child node is being + * created and added to the content model. + * + * The HTMLContentSink interface assumes 4 underlying + * containers: HTML, HEAD, BODY and FRAMESET. Before + * accessing any these, the parser will call the appropriate + * OpennsIHTMLContentSink method: OpenHTML,OpenHead,OpenBody,OpenFrameSet; + * likewise, the ClosensIHTMLContentSink version will be called when the + * parser is done with a given section. + * + * IMPORTANT: The parser may Open each container more than + * once! This is due to the irregular nature of HTML files. + * For example, it is possible to encounter plain text at + * the start of an HTML document (that precedes the HTML tag). + * Such text is treated as if it were part of the body. + * In such cases, the parser will Open the body, pass the text- + * node in and then Close the body. The body will likely be + * re-Opened later when the actual <BODY> tag has been seen. + * + * Containers within the body are Opened and Closed + * using the OpenContainer(...) and CloseContainer(...) calls. + * It is assumed that the document or contentSink is + * maintaining its state to manage where new content should + * be added to the underlying document. + * + * NOTE: OpenHTML() and OpenBody() may get called multiple times + * in the same document. That's fine, and it doesn't mean + * that we have multiple bodies or HTML's. + * + * NOTE: I haven't figured out how sub-documents (non-frames) + * are going to be handled. Stay tuned. + */ +#include "nsIContentSink.h" +#include "nsHTMLTags.h" + +#define NS_IHTML_CONTENT_SINK_IID \ + {0xefc5af86, 0x5cfd, 0x4918, {0x9d, 0xd3, 0x5f, 0x7a, 0xb2, 0x88, 0xb2, 0x68}} + +/** + * This interface is OBSOLETE and in the process of being REMOVED. + * Do NOT implement! + */ +class nsIHTMLContentSink : public nsIContentSink +{ +public: + + NS_DECLARE_STATIC_IID_ACCESSOR(NS_IHTML_CONTENT_SINK_IID) + + enum ElementType { eHTML, eBody }; + + /** + * This method is used to open a generic container in the sink. + * + * @update 4/1/98 gess + */ + NS_IMETHOD OpenContainer(ElementType aNodeType) = 0; + + /** + * This method gets called by the parser when a close + * container tag has been consumed and needs to be closed. + * + * @param aTag - The tag to be closed. + */ + NS_IMETHOD CloseContainer(ElementType aTag) = 0; +}; + +NS_DEFINE_STATIC_IID_ACCESSOR(nsIHTMLContentSink, NS_IHTML_CONTENT_SINK_IID) + +#endif /* nsIHTMLContentSink_h___ */ + |