summaryrefslogtreecommitdiff
path: root/src/HTML5/Parser/DOMTreeBuilder.php
diff options
context:
space:
mode:
Diffstat (limited to 'src/HTML5/Parser/DOMTreeBuilder.php')
-rw-r--r--src/HTML5/Parser/DOMTreeBuilder.php850
1 files changed, 444 insertions, 406 deletions
diff --git a/src/HTML5/Parser/DOMTreeBuilder.php b/src/HTML5/Parser/DOMTreeBuilder.php
index 3bf5713..9e77312 100644
--- a/src/HTML5/Parser/DOMTreeBuilder.php
+++ b/src/HTML5/Parser/DOMTreeBuilder.php
@@ -2,6 +2,7 @@
namespace Masterminds\HTML5\Parser;
use Masterminds\HTML5\Elements;
+
/**
* Create an HTML5 DOM tree from events.
*
@@ -20,456 +21,493 @@ use Masterminds\HTML5\Elements;
* re-written to accomodate this. See, for example, the Go language HTML5
* parser.
*/
-class DOMTreeBuilder implements EventHandler {
-
-
- /**
- * Defined in 8.2.5.
- */
- const IM_INITIAL = 0;
- const IM_BEFORE_HTML = 1;
- const IM_BEFORE_HEAD = 2;
- const IM_IN_HEAD = 3;
- const IM_IN_HEAD_NOSCRIPT = 4;
- const IM_AFTER_HEAD = 5;
- const IM_IN_BODY = 6;
- const IM_TEXT = 7;
- const IM_IN_TABLE = 8;
- const IM_IN_TABLE_TEXT = 9;
- const IM_IN_CAPTION = 10;
- const IM_IN_COLUMN_GROUP = 11;
- const IM_IN_TABLE_BODY = 12;
- const IM_IN_ROW = 13;
- const IM_IN_CELL = 14;
- const IM_IN_SELECT = 15;
- const IM_IN_SELECT_IN_TABLE = 16;
- const IM_AFTER_BODY = 17;
- const IM_IN_FRAMESET = 18;
- const IM_AFTER_FRAMESET = 19;
- const IM_AFTER_AFTER_BODY = 20;
- const IM_AFTER_AFTER_FRAMESET = 21;
-
- const IM_IN_SVG = 22;
- const IM_IN_MATHML = 23;
-
- protected $stack = array();
- protected $current; // Pointer in the tag hierarchy.
- protected $doc;
-
- protected $processor;
-
- protected $insertMode = 0;
-
- /**
- * Quirks mode is enabled by default. Any document that is missing the
- * DT will be considered to be in quirks mode.
- */
- protected $quirks = TRUE;
-
- public $isFragment = FALSE;
-
- public function __construct($isFragment = FALSE) {
- $impl = new \DOMImplementation();
- // XXX:
- // Create the doctype. For now, we are always creating HTML5
- // documents, and attempting to up-convert any older DTDs to HTML5.
- $dt = $impl->createDocumentType('html');
- //$this->doc = \DOMImplementation::createDocument(NULL, 'html', $dt);
- $this->doc = $impl->createDocument(NULL, NULL, $dt);
- $this->doc->errors = array();
-
- // $this->current = $this->doc->documentElement;
- $this->current = $this->doc; //->documentElement;
-
- // Create a rules engine for tags.
- $this->rules = new TreeBuildingRules($this->doc);
-
- if ($isFragment) {
- $this->isFragment = TRUE;
- $this->insertMode = static::IM_IN_BODY;
- $ele = $this->doc->createElement('html');
- $this->doc->appendChild($ele);
- $this->current = $ele;
- }
- }
-
- /**
- * Get the document.
- */
- public function document() {
- return $this->doc;
- }
-
- /**
- * Get the DOM fragment for the body.
- *
- * This returns a DOMNodeList because a fragment may have zero or more
- * DOMNodes at its root.
- *
- * @see http://www.w3.org/TR/2012/CR-html5-20121217/syntax.html#concept-frag-parse-context
- *
- * @return \DOMFragmentDocumentFragment
- */
- public function fragment() {
- $append = $this->doc->documentElement->childNodes;
- $frag = $this->doc->createDocumentFragment();
-
- // appendChild() modifies the DOMNodeList, so we
- // have to buffer up the items first, then use the
- // array buffer and loop twice.
- $buffer = array();
- foreach ($append as $node) {
- $buffer[] = $node;
- }
+class DOMTreeBuilder implements EventHandler
+{
- foreach ($buffer as $node) {
- $frag->appendChild($node);
- }
+ /**
+ * Defined in 8.2.5.
+ */
+ const IM_INITIAL = 0;
- $frag->errors = $this->doc->errors;
- return $frag;
- }
-
- /**
- * Provide an instruction processor.
- *
- * This is used for handling Processor Instructions as they are
- * inserted. If omitted, PI's are inserted directly into the DOM tree.
- */
- public function setInstructionProcessor(\Masterminds\HTML5\InstructionProcessor $proc) {
- $this->processor = $proc;
- }
-
- public function doctype($name, $idType = 0, $id = NULL, $quirks = FALSE) {
- // This is used solely for setting quirks mode. Currently we don't
- // try to preserve the inbound DT. We convert it to HTML5.
- $this->quirks = $quirks;
-
- if ($this->insertMode > static::IM_INITIAL) {
- $this->parseError("Illegal placement of DOCTYPE tag. Ignoring: " . $name);
- return;
- }
+ const IM_BEFORE_HTML = 1;
- $this->insertMode = static::IM_BEFORE_HTML;
- }
-
- /**
- * Process the start tag.
- *
- * @todo
- * - XMLNS namespace handling (we need to parse, even if it's not valid)
- * - XLink, MathML and SVG namespace handling
- * - Omission rules: 8.1.2.4 Optional tags
- */
- public function startTag($name, $attributes = array(), $selfClosing = FALSE) {
- // fprintf(STDOUT, $name);
- $lname = $this->normalizeTagName($name);
-
- // Make sure we have an html element.
- if (!$this->doc->documentElement && $name !== 'html') {
- $this->startTag('html');
- }
+ const IM_BEFORE_HEAD = 2;
- // Set quirks mode if we're at IM_INITIAL with no doctype.
- if ($this->insertMode == static::IM_INITIAL) {
- $this->quirks = TRUE;
- $this->parseError("No DOCTYPE specified.");
- }
+ const IM_IN_HEAD = 3;
- // SPECIAL TAG HANDLING:
- // Spec says do this, and "don't ask."
- if ($name == 'image') {
- $name = 'img';
- }
+ const IM_IN_HEAD_NOSCRIPT = 4;
+ const IM_AFTER_HEAD = 5;
- // Autoclose p tags where appropriate.
- if ($this->insertMode >= static::IM_IN_BODY && Elements::isA($name, Elements::AUTOCLOSE_P)) {
- $this->autoclose('p');
- }
+ const IM_IN_BODY = 6;
- // Set insert mode:
- switch ($name) {
- case 'html':
- $this->insertMode = static::IM_BEFORE_HEAD;
- break;
- case 'head':
- if ($this->insertMode > static::IM_BEFORE_HEAD) {
- $this->parseError("Unexpected head tag outside of head context.");
- }
- else {
- $this->insertMode = static::IM_IN_HEAD;
- }
- break;
- case 'body':
- $this->insertMode = static::IM_IN_BODY;
- break;
- case 'svg':
- $this->insertMode = static::IM_IN_SVG;
- break;
- case 'math':
- $this->insertMode = static::IM_IN_MATHML;
- break;
- case 'noscript':
- if ($this->insertMode == static::IM_IN_HEAD) {
- $this->insertMode = static::IM_IN_HEAD_NOSCRIPT;
- }
- break;
+ const IM_TEXT = 7;
- }
+ const IM_IN_TABLE = 8;
- // Special case handling for SVG.
- if ($this->insertMode == static::IM_IN_SVG) {
- $lname = Elements::normalizeSvgElement($lname);
- }
+ const IM_IN_TABLE_TEXT = 9;
- try {
- $ele = $this->doc->createElement($lname);
- }
- catch(\DOMException $e) {
- $this->parseError("Illegal tag name: <$lname>. Replaced with <invalid>.");
- $ele = $this->doc->createElement('invalid');
- }
+ const IM_IN_CAPTION = 10;
+
+ const IM_IN_COLUMN_GROUP = 11;
+
+ const IM_IN_TABLE_BODY = 12;
+
+ const IM_IN_ROW = 13;
+
+ const IM_IN_CELL = 14;
+
+ const IM_IN_SELECT = 15;
+
+ const IM_IN_SELECT_IN_TABLE = 16;
+
+ const IM_AFTER_BODY = 17;
+
+ const IM_IN_FRAMESET = 18;
+
+ const IM_AFTER_FRAMESET = 19;
+
+ const IM_AFTER_AFTER_BODY = 20;
+
+ const IM_AFTER_AFTER_FRAMESET = 21;
+
+ const IM_IN_SVG = 22;
+
+ const IM_IN_MATHML = 23;
+
+ protected $stack = array();
- foreach ($attributes as $aName => $aVal) {
-
- if ($this->insertMode == static::IM_IN_SVG) {
- $aName = Elements::normalizeSvgAttribute($aName);
- }
- elseif ($this->insertMode == static::IM_IN_MATHML) {
- $aName = Elements::normalizeMathMlAttribute($aName);
- }
-
- try {
- $ele->setAttribute($aName, $aVal);
- }
- catch(\DOMException $e) {
- $this->parseError("Illegal attribute name for tag $name. Ignoring: $aName");
- continue;
- }
-
- // This is necessary on a non-DTD schema, like HTML5.
- if ($aName == 'id') {
- $ele->setIdAttribute('id', TRUE);
- }
+ protected $current; // Pointer in the tag hierarchy.
+ protected $doc;
+
+ protected $processor;
+
+ protected $insertMode = 0;
+
+ /**
+ * Quirks mode is enabled by default.
+ * Any document that is missing the
+ * DT will be considered to be in quirks mode.
+ */
+ protected $quirks = TRUE;
+
+ public $isFragment = FALSE;
+
+ public function __construct($isFragment = FALSE)
+ {
+ $impl = new \DOMImplementation();
+ // XXX:
+ // Create the doctype. For now, we are always creating HTML5
+ // documents, and attempting to up-convert any older DTDs to HTML5.
+ $dt = $impl->createDocumentType('html');
+ // $this->doc = \DOMImplementation::createDocument(NULL, 'html', $dt);
+ $this->doc = $impl->createDocument(NULL, NULL, $dt);
+ $this->doc->errors = array();
+
+ // $this->current = $this->doc->documentElement;
+ $this->current = $this->doc; // ->documentElement;
+
+ // Create a rules engine for tags.
+ $this->rules = new TreeBuildingRules($this->doc);
+
+ if ($isFragment) {
+ $this->isFragment = TRUE;
+ $this->insertMode = static::IM_IN_BODY;
+ $ele = $this->doc->createElement('html');
+ $this->doc->appendChild($ele);
+ $this->current = $ele;
+ }
}
- // Some elements have special processing rules. Handle those separately.
- if ($this->rules->hasRules($name)) {
- $this->current = $this->rules->evaluate($ele, $this->current);
+ /**
+ * Get the document.
+ */
+ public function document()
+ {
+ return $this->doc;
}
- // Otherwise, it's a standard element.
- else {
- $this->current->appendChild($ele);
-
- // XXX: Need to handle self-closing tags and unary tags.
- if (!Elements::isA($name, Elements::VOID_TAG)) {
- $this->current = $ele;
- }
+
+ /**
+ * Get the DOM fragment for the body.
+ *
+ * This returns a DOMNodeList because a fragment may have zero or more
+ * DOMNodes at its root.
+ *
+ * @see http://www.w3.org/TR/2012/CR-html5-20121217/syntax.html#concept-frag-parse-context
+ *
+ * @return \DOMFragmentDocumentFragment
+ */
+ public function fragment()
+ {
+ $append = $this->doc->documentElement->childNodes;
+ $frag = $this->doc->createDocumentFragment();
+
+ // appendChild() modifies the DOMNodeList, so we
+ // have to buffer up the items first, then use the
+ // array buffer and loop twice.
+ $buffer = array();
+ foreach ($append as $node) {
+ $buffer[] = $node;
+ }
+
+ foreach ($buffer as $node) {
+ $frag->appendChild($node);
+ }
+
+ $frag->errors = $this->doc->errors;
+
+ return $frag;
}
- // This is sort of a last-ditch attempt to correct for cases where no head/body
- // elements are provided.
- if ($this->insertMode <= static::IM_BEFORE_HEAD && $name != 'head' && $name != 'html') {
- $this->insertMode = static::IM_IN_BODY;
+ /**
+ * Provide an instruction processor.
+ *
+ * This is used for handling Processor Instructions as they are
+ * inserted. If omitted, PI's are inserted directly into the DOM tree.
+ */
+ public function setInstructionProcessor(\Masterminds\HTML5\InstructionProcessor $proc)
+ {
+ $this->processor = $proc;
}
- // Return the element mask, which the tokenizer can then use to set
- // various processing rules.
- return Elements::element($name);
- }
+ public function doctype($name, $idType = 0, $id = NULL, $quirks = FALSE)
+ {
+ // This is used solely for setting quirks mode. Currently we don't
+ // try to preserve the inbound DT. We convert it to HTML5.
+ $this->quirks = $quirks;
- public function endTag($name) {
- $lname = $this->normalizeTagName($name);
+ if ($this->insertMode > static::IM_INITIAL) {
+ $this->parseError("Illegal placement of DOCTYPE tag. Ignoring: " . $name);
- // Ignore closing tags for unary elements.
- if (Elements::isA($name, Elements::VOID_TAG)) {
- return;
- }
+ return;
+ }
- if ($this->insertMode <= static::IM_BEFORE_HTML) {
- // 8.2.5.4.2
- if (in_array($name, array('html', 'br', 'head', 'title'))) {
- $this->startTag('html');
- $this->endTag($name);
- $this->insertMode = static::IM_BEFORE_HEAD;
- return;
- }
-
- // Ignore the tag.
- $this->parseError("Illegal closing tag at global scope.");
- return;
+ $this->insertMode = static::IM_BEFORE_HTML;
}
- // Special case handling for SVG.
- if ($this->insertMode == static::IM_IN_SVG) {
- $lname = Elements::normalizeSvgElement($lname);
+ /**
+ * Process the start tag.
+ *
+ * @todo - XMLNS namespace handling (we need to parse, even if it's not valid)
+ * - XLink, MathML and SVG namespace handling
+ * - Omission rules: 8.1.2.4 Optional tags
+ */
+ public function startTag($name, $attributes = array(), $selfClosing = FALSE)
+ {
+ // fprintf(STDOUT, $name);
+ $lname = $this->normalizeTagName($name);
+
+ // Make sure we have an html element.
+ if (! $this->doc->documentElement && $name !== 'html') {
+ $this->startTag('html');
+ }
+
+ // Set quirks mode if we're at IM_INITIAL with no doctype.
+ if ($this->insertMode == static::IM_INITIAL) {
+ $this->quirks = TRUE;
+ $this->parseError("No DOCTYPE specified.");
+ }
+
+ // SPECIAL TAG HANDLING:
+ // Spec says do this, and "don't ask."
+ if ($name == 'image') {
+ $name = 'img';
+ }
+
+ // Autoclose p tags where appropriate.
+ if ($this->insertMode >= static::IM_IN_BODY && Elements::isA($name, Elements::AUTOCLOSE_P)) {
+ $this->autoclose('p');
+ }
+
+ // Set insert mode:
+ switch ($name) {
+ case 'html':
+ $this->insertMode = static::IM_BEFORE_HEAD;
+ break;
+ case 'head':
+ if ($this->insertMode > static::IM_BEFORE_HEAD) {
+ $this->parseError("Unexpected head tag outside of head context.");
+ } else {
+ $this->insertMode = static::IM_IN_HEAD;
+ }
+ break;
+ case 'body':
+ $this->insertMode = static::IM_IN_BODY;
+ break;
+ case 'svg':
+ $this->insertMode = static::IM_IN_SVG;
+ break;
+ case 'math':
+ $this->insertMode = static::IM_IN_MATHML;
+ break;
+ case 'noscript':
+ if ($this->insertMode == static::IM_IN_HEAD) {
+ $this->insertMode = static::IM_IN_HEAD_NOSCRIPT;
+ }
+ break;
+ }
+
+ // Special case handling for SVG.
+ if ($this->insertMode == static::IM_IN_SVG) {
+ $lname = Elements::normalizeSvgElement($lname);
+ }
+
+ try {
+ $ele = $this->doc->createElement($lname);
+ } catch (\DOMException $e) {
+ $this->parseError("Illegal tag name: <$lname>. Replaced with <invalid>.");
+ $ele = $this->doc->createElement('invalid');
+ }
+
+ foreach ($attributes as $aName => $aVal) {
+
+ if ($this->insertMode == static::IM_IN_SVG) {
+ $aName = Elements::normalizeSvgAttribute($aName);
+ } elseif ($this->insertMode == static::IM_IN_MATHML) {
+ $aName = Elements::normalizeMathMlAttribute($aName);
+ }
+
+ try {
+ $ele->setAttribute($aName, $aVal);
+ } catch (\DOMException $e) {
+ $this->parseError("Illegal attribute name for tag $name. Ignoring: $aName");
+ continue;
+ }
+
+ // This is necessary on a non-DTD schema, like HTML5.
+ if ($aName == 'id') {
+ $ele->setIdAttribute('id', TRUE);
+ }
+ }
+
+ // Some elements have special processing rules. Handle those separately.
+ if ($this->rules->hasRules($name)) {
+ $this->current = $this->rules->evaluate($ele, $this->current);
+ } // Otherwise, it's a standard element.
+ else {
+ $this->current->appendChild($ele);
+
+ // XXX: Need to handle self-closing tags and unary tags.
+ if (! Elements::isA($name, Elements::VOID_TAG)) {
+ $this->current = $ele;
+ }
+ }
+
+ // This is sort of a last-ditch attempt to correct for cases where no head/body
+ // elements are provided.
+ if ($this->insertMode <= static::IM_BEFORE_HEAD && $name != 'head' && $name != 'html') {
+ $this->insertMode = static::IM_IN_BODY;
+ }
+
+ // Return the element mask, which the tokenizer can then use to set
+ // various processing rules.
+ return Elements::element($name);
}
- // XXX: Not sure whether we need this anymore.
- // if ($name != $lname) {
- // return $this->quirksTreeResolver($lname);
- //}
-
- // XXX: HTML has no parent. What do we do, though,
- // if this element appears in the wrong place?
- if ($lname == 'html') {
- return;
+ public function endTag($name)
+ {
+ $lname = $this->normalizeTagName($name);
+
+ // Ignore closing tags for unary elements.
+ if (Elements::isA($name, Elements::VOID_TAG)) {
+ return;
+ }
+
+ if ($this->insertMode <= static::IM_BEFORE_HTML) {
+ // 8.2.5.4.2
+ if (in_array($name, array(
+ 'html',
+ 'br',
+ 'head',
+ 'title'
+ ))) {
+ $this->startTag('html');
+ $this->endTag($name);
+ $this->insertMode = static::IM_BEFORE_HEAD;
+
+ return;
+ }
+
+ // Ignore the tag.
+ $this->parseError("Illegal closing tag at global scope.");
+
+ return;
+ }
+
+ // Special case handling for SVG.
+ if ($this->insertMode == static::IM_IN_SVG) {
+ $lname = Elements::normalizeSvgElement($lname);
+ }
+
+ // XXX: Not sure whether we need this anymore.
+ // if ($name != $lname) {
+ // return $this->quirksTreeResolver($lname);
+ // }
+
+ // XXX: HTML has no parent. What do we do, though,
+ // if this element appears in the wrong place?
+ if ($lname == 'html') {
+ return;
+ }
+
+ // $this->current = $this->current->parentNode;
+ if (! $this->autoclose($lname)) {
+ $this->parseError('Could not find closing tag for ' . $lname);
+ }
+
+ // switch ($this->insertMode) {
+ switch ($lname) {
+ case "head":
+ $this->insertMode = static::IM_AFTER_HEAD;
+ break;
+ case "body":
+ $this->insertMode = static::IM_AFTER_BODY;
+ break;
+ case "svg":
+ case "mathml":
+ $this->insertMode = static::IM_IN_BODY;
+ break;
+ }
}
- //$this->current = $this->current->parentNode;
- if (!$this->autoclose($lname)) {
- $this->parseError('Could not find closing tag for ' . $lname);
+ public function comment($cdata)
+ {
+ // TODO: Need to handle case where comment appears outside of the HTML tag.
+ $node = $this->doc->createComment($cdata);
+ $this->current->appendChild($node);
}
- //switch ($this->insertMode) {
- switch ($lname) {
- case "head":
- $this->insertMode = static::IM_AFTER_HEAD;
- break;
- case "body":
- $this->insertMode = static::IM_AFTER_BODY;
- break;
- case "svg":
- case "mathml":
- $this->insertMode = static::IM_IN_BODY;
- break;
+ public function text($data)
+ {
+ // XXX: Hmmm.... should we really be this strict?
+ if ($this->insertMode < static::IM_IN_HEAD) {
+ // Per '8.2.5.4.3 The "before head" insertion mode' the characters
+ // " \t\n\r\f" should be ignored but no mention of a parse error. This is
+ // practical as most documents contain these characters. Other text is not
+ // expected here so recording a parse error is necessary.
+ $dataTmp = trim($data, " \t\n\r\f");
+ if (! empty($dataTmp)) {
+ // fprintf(STDOUT, "Unexpected insert mode: %d", $this->insertMode);
+ $this->parseError("Unexpected text. Ignoring: " . $dataTmp);
+ }
+
+ return;
+ }
+ // fprintf(STDOUT, "Appending text %s.", $data);
+ $node = $this->doc->createTextNode($data);
+ $this->current->appendChild($node);
}
- }
-
- public function comment($cdata) {
- // TODO: Need to handle case where comment appears outside of the HTML tag.
- $node = $this->doc->createComment($cdata);
- $this->current->appendChild($node);
- }
-
- public function text($data) {
- // XXX: Hmmm.... should we really be this strict?
- if ($this->insertMode < static::IM_IN_HEAD) {
- // Per '8.2.5.4.3 The "before head" insertion mode' the characters
- // " \t\n\r\f" should be ignored but no mention of a parse error. This is
- // practical as most documents contain these characters. Other text is not
- // expected here so recording a parse error is necessary.
- $dataTmp = trim($data, " \t\n\r\f");
- if (!empty($dataTmp)) {
- //fprintf(STDOUT, "Unexpected insert mode: %d", $this->insertMode);
- $this->parseError("Unexpected text. Ignoring: " . $dataTmp);
- }
- return;
+
+ public function eof()
+ {
+ // If the $current isn't the $root, do we need to do anything?
}
- //fprintf(STDOUT, "Appending text %s.", $data);
- $node = $this->doc->createTextNode($data);
- $this->current->appendChild($node);
- }
-
- public function eof() {
- // If the $current isn't the $root, do we need to do anything?
- }
-
- public function parseError($msg, $line = 0, $col = 0) {
- $this->doc->errors[] = sprintf("Line %d, Col %d: %s", $line, $col, $msg);
- }
-
- public function cdata($data) {
- $node = $this->doc->createCDATASection($data);
- $this->current->appendChild($node);
- }
-
- public function processingInstruction($name, $data = NULL) {
- // XXX: Ignore initial XML declaration, per the spec.
- if ($this->insertMode == static::IM_INITIAL && 'xml' == strtolower($name)) {
- return;
+
+ public function parseError($msg, $line = 0, $col = 0)
+ {
+ $this->doc->errors[] = sprintf("Line %d, Col %d: %s", $line, $col, $msg);
}
- // Important: The processor may modify the current DOM tree however
- // it sees fit.
- if (isset($this->processor)) {
- $res = $this->processor->process($this->current, $name, $data);
- if (!empty($res)) {
- $this->current = $res;
- }
- return;
+ public function cdata($data)
+ {
+ $node = $this->doc->createCDATASection($data);
+ $this->current->appendChild($node);
}
- // Otherwise, this is just a dumb PI element.
- $node = $this->doc->createProcessingInstruction($name, $data);
-
- $this->current->appendChild($node);
- }
-
- // ==========================================================================
- // UTILITIES
- // ==========================================================================
-
- /**
- * Apply normalization rules to a tag name.
- *
- * See sections 2.9 and 8.1.2.
- *
- * @param string $name
- * The tag name.
- * @return string
- * The normalized tag name.
- */
- protected function normalizeTagName($name) {
- /* Section 2.9 suggests that we should not do this.
- if (strpos($name, ':') !== FALSE) {
- // We know from the grammar that there must be at least one other
- // char besides :, since : is not a legal tag start.
- $parts = explode(':', $name);
- return array_pop($parts);
+ public function processingInstruction($name, $data = NULL)
+ {
+ // XXX: Ignore initial XML declaration, per the spec.
+ if ($this->insertMode == static::IM_INITIAL && 'xml' == strtolower($name)) {
+ return;
+ }
+
+ // Important: The processor may modify the current DOM tree however
+ // it sees fit.
+ if (isset($this->processor)) {
+ $res = $this->processor->process($this->current, $name, $data);
+ if (! empty($res)) {
+ $this->current = $res;
+ }
+
+ return;
+ }
+
+ // Otherwise, this is just a dumb PI element.
+ $node = $this->doc->createProcessingInstruction($name, $data);
+
+ $this->current->appendChild($node);
}
- */
- return $name;
- }
+ // ==========================================================================
+ // UTILITIES
+ // ==========================================================================
+
+ /**
+ * Apply normalization rules to a tag name.
+ *
+ * See sections 2.9 and 8.1.2.
+ *
+ * @param string $name
+ * The tag name.
+ * @return string The normalized tag name.
+ */
+ protected function normalizeTagName($name)
+ {
+ /*
+ * Section 2.9 suggests that we should not do this. if (strpos($name, ':') !== FALSE) { // We know from the grammar that there must be at least one other // char besides :, since : is not a legal tag start. $parts = explode(':', $name); return array_pop($parts); }
+ */
+ return $name;
+ }
- protected function quirksTreeResolver($name) {
- throw new \Exception("Not implemented.");
+ protected function quirksTreeResolver($name)
+ {
+ throw new \Exception("Not implemented.");
+ }
- }
+ /**
+ * Automatically climb the tree and close the closest node with the matching $tag.
+ */
+ protected function autoclose($tag)
+ {
+ $working = $this->current;
+ do {
+ if ($working->nodeType != XML_ELEMENT_NODE) {
+ return FALSE;
+ }
+ if ($working->tagName == $tag) {
+ $this->current = $working->parentNode;
+
+ return TRUE;
+ }
+ } while ($working = $working->parentNode);
- /**
- * Automatically climb the tree and close the closest node with the matching $tag.
- */
- protected function autoclose($tag) {
- $working = $this->current;
- do {
- if ($working->nodeType != XML_ELEMENT_NODE) {
return FALSE;
- }
- if ($working->tagName == $tag) {
- $this->current = $working->parentNode;
- return TRUE;
- }
- } while ($working = $working->parentNode);
- return FALSE;
-
- }
-
- /**
- * Checks if the given tagname is an ancestor of the present candidate.
- *
- * If $this->current or anything above $this->current matches the given tag
- * name, this returns TRUE.
- */
- protected function isAncestor($tagname) {
- $candidate = $this->current;
- while ($candidate->nodeType === XML_ELEMENT_NODE) {
- if ($candidate->tagName == $tagname) {
- return TRUE;
- }
- $candidate = $candidate->parentNode;
}
- return FALSE;
- }
- /**
- * Returns TRUE if the immediate parent element is of the given tagname.
- */
- protected function isParent($tagname) {
- return $this->current->tagName == $tagname;
- }
+ /**
+ * Checks if the given tagname is an ancestor of the present candidate.
+ *
+ * If $this->current or anything above $this->current matches the given tag
+ * name, this returns TRUE.
+ */
+ protected function isAncestor($tagname)
+ {
+ $candidate = $this->current;
+ while ($candidate->nodeType === XML_ELEMENT_NODE) {
+ if ($candidate->tagName == $tagname) {
+ return TRUE;
+ }
+ $candidate = $candidate->parentNode;
+ }
+ return FALSE;
+ }
+ /**
+ * Returns TRUE if the immediate parent element is of the given tagname.
+ */
+ protected function isParent($tagname)
+ {
+ return $this->current->tagName == $tagname;
+ }
}
generated by cgit v1.2.3 (git 2.25.1) at 2024-06-28 10:37:02 +0000