mirror of
https://github.com/silverstripe/silverstripe-framework
synced 2024-09-16 14:36:26 +02:00
2335c074b3
Shortcodes have traditionally had a problem that they are inside <p> tags, but generate block level elements. This breaks HTML compliance. This makes the shortcode parser now mutate the DOM based on the "class" attribute on the shortcode to insert the generated block level element at the right place in the DOM - for "left" and "right" elements it puts them just before the block level element they are inside - for "leftAlone" and "center" elements it splits the DOM around the shortcode. The trade off is that shortcodes are no longer "text level" features. They need knowledge of the HTML they are in to perform this transformation, so they can only be used in (valid) HTML
37 lines
1.1 KiB
PHP
37 lines
1.1 KiB
PHP
<?php
|
|
|
|
require_once dirname(__FILE__) . '/Data.php';
|
|
require_once dirname(__FILE__) . '/InputStream.php';
|
|
require_once dirname(__FILE__) . '/TreeBuilder.php';
|
|
require_once dirname(__FILE__) . '/Tokenizer.php';
|
|
|
|
/**
|
|
* Outwards facing interface for HTML5.
|
|
*/
|
|
class HTML5_Parser
|
|
{
|
|
/**
|
|
* Parses a full HTML document.
|
|
* @param $text HTML text to parse
|
|
* @param $builder Custom builder implementation
|
|
* @return Parsed HTML as DOMDocument
|
|
*/
|
|
static public function parse($text, $builder = null) {
|
|
$tokenizer = new HTML5_Tokenizer($text, $builder);
|
|
$tokenizer->parse();
|
|
return $tokenizer->save();
|
|
}
|
|
/**
|
|
* Parses an HTML fragment.
|
|
* @param $text HTML text to parse
|
|
* @param $context String name of context element to pretend parsing is in.
|
|
* @param $builder Custom builder implementation
|
|
* @return Parsed HTML as DOMDocument
|
|
*/
|
|
static public function parseFragment($text, $context = null, $builder = null) {
|
|
$tokenizer = new HTML5_Tokenizer($text, $builder);
|
|
$tokenizer->parseFragment($context);
|
|
return $tokenizer->save();
|
|
}
|
|
}
|