enmi-conf.org: comparison wp/wp-includes/class-wp-block-parser.php

equal deleted inserted replaced

-:34716fd837a4
+:be944660c56a
 /**
 * Class WP_Block_Parser_Block
 *
 * Holds the block structure in memory
 *
-* @since 3.8.0
+* @since 5.0.0
 */
 class WP_Block_Parser_Block {
 	/**
 	 * Name of block
 	 *
 	 * @example "core/paragraph"
 	 *
-	 * @since 3.8.0
+	 * @since 5.0.0
 	 * @var string
 	 */
 	public $blockName;
 	/**
 	 * Optional set of attributes from block comment delimiters
 	 *
 	 * @example null
 	 * @example array( 'columns' => 3 )
 	 *
-	 * @since 3.8.0
+	 * @since 5.0.0
 	 * @var array|null
 	 */
 	public $attrs;
 	/**
 	 * List of inner blocks (of this same class)
 	 *
-	 * @since 3.8.0
+	 * @since 5.0.0
 	 * @var WP_Block_Parser_Block[]
 	 */
 	public $innerBlocks;
 	/**
 	 * Resultant HTML from inside block comment delimiters
 	 * after removing inner blocks
 	 *
 	 * @example "...Just <!-- wp:test /--> testing..." -> "Just testing..."
 	 *
-	 * @since 3.8.0
+	 * @since 5.0.0
 	 * @var string
 	 */
 	public $innerHTML;
 	/**
 	/**
 	 * Constructor.
 	 *
 	 * Will populate object properties from the provided arguments.
 	 *
-	 * @since 3.8.0
+	 * @since 5.0.0
 	 *
 	 * @param string $name         Name of block.
 	 * @param array  $attrs        Optional set of attributes from block comment delimiters.
 	 * @param array  $innerBlocks  List of inner blocks (of this same class).
 	 * @param string $innerHTML    Resultant HTML from inside block comment delimiters after removing inner blocks.
 * Class WP_Block_Parser_Frame
 *
 * Holds partial blocks in memory while parsing
 *
 * @internal
-* @since 3.8.0
+* @since 5.0.0
 */
 class WP_Block_Parser_Frame {
 	/**
 	 * Full or partial block
 	 *
-	 * @since 3.8.0
+	 * @since 5.0.0
 	 * @var WP_Block_Parser_Block
 	 */
 	public $block;
 	/**
 	 * Byte offset into document for start of parse token
 	 *
-	 * @since 3.8.0
+	 * @since 5.0.0
 	 * @var int
 	 */
 	public $token_start;
 	/**
 	 * Byte length of entire parse token string
 	 *
-	 * @since 3.8.0
+	 * @since 5.0.0
 	 * @var int
 	 */
 	public $token_length;
 	/**
 	 * Byte offset into document for after parse token ends
 	 * (used during reconstruction of stack into parse production)
 	 *
-	 * @since 3.8.0
+	 * @since 5.0.0
 	 * @var int
 	 */
 	public $prev_offset;
 	/**
 	 * Byte offset into document where leading HTML before token starts
 	 *
-	 * @since 3.8.0
+	 * @since 5.0.0
 	 * @var int
 	 */
 	public $leading_html_start;
 	/**
 	 * Constructor
 	 *
 	 * Will populate object properties from the provided arguments.
 	 *
-	 * @since 3.8.0
+	 * @since 5.0.0
 	 *
 	 * @param WP_Block_Parser_Block $block              Full or partial block.
 	 * @param int                   $token_start        Byte offset into document for start of parse token.
 	 * @param int                   $token_length       Byte length of entire parse token string.
 	 * @param int                   $prev_offset        Byte offset into document for after parse token ends.
 /**
 * Class WP_Block_Parser
 *
 * Parses a document and constructs a list of parsed block objects
 *
-* @since 3.8.0
+* @since 5.0.0
 * @since 4.0.0 returns arrays not objects, all attributes are arrays
 */
 class WP_Block_Parser {
 	/**
 	 * Input document being parsed
 	 *
 	 * @example "Pre-text\n<!-- wp:paragraph -->This is inside a block!<!-- /wp:paragraph -->"
 	 *
-	 * @since 3.8.0
+	 * @since 5.0.0
 	 * @var string
 	 */
 	public $document;
 	/**
 	 * Tracks parsing progress through document
 	 *
-	 * @since 3.8.0
+	 * @since 5.0.0
 	 * @var int
 	 */
 	public $offset;
 	/**
 	 * List of parsed blocks
 	 *
-	 * @since 3.8.0
+	 * @since 5.0.0
 	 * @var WP_Block_Parser_Block[]
 	 */
 	public $output;
 	/**
 	 * Stack of partially-parsed structures in memory during parse
 	 *
-	 * @since 3.8.0
+	 * @since 5.0.0
 	 * @var WP_Block_Parser_Frame[]
 	 */
 	public $stack;
 	/**
 	 *
 	 * When encountering an invalid parse will return a best-effort
 	 * parse. In contrast to the specification parser this does not
 	 * return an error on invalid inputs.
 	 *
-	 * @since 3.8.0
+	 * @since 5.0.0
 	 *
 	 * @param string $document Input document being parsed.
 	 * @return WP_Block_Parser_Block[]
 	 */
 	function parse( $document ) {
 	 * with that token before descending deeper into a
 	 * nested block tree or continuing along the document
 	 * or breaking out of a level of nesting.
 	 *
 	 * @internal
-	 * @since 3.8.0
+	 * @since 5.0.0
 	 * @return bool
 	 */
 	function proceed() {
 		$next_token = $this->next_token();
 		list( $token_type, $block_name, $attrs, $start_offset, $token_length ) = $next_token;
 				 * easy case is if we stumbled upon a void block
 				 * in the top-level of the document
 				 */
 				if ( 0 === $stack_depth ) {
 					if ( isset( $leading_html_start ) ) {
-						$this->output[] = (array) self::freeform(
+						$this->output[] = (array) $this->freeform(
 							substr(
 								$this->document,
 								$leading_html_start,
 								$start_offset - $leading_html_start
 							)
 	 * and finds the next valid token to parse if it exists
 	 *
 	 * Returns the type of the find: kind of find, block information, attributes
 	 *
 	 * @internal
-	 * @since 3.8.0
+	 * @since 5.0.0
 	 * @since 4.6.1 fixed a bug in attribute parsing which caused catastrophic backtracking on invalid block comments
 	 * @return array
 	 */
 	function next_token() {
 		$matches = null;
 	/**
 	 * Pushes a length of text from the input document
 	 * to the output list as a freeform block.
 	 *
 	 * @internal
-	 * @since 3.8.0
+	 * @since 5.0.0
 	 * @param null $length how many bytes of document text to output.
 	 */
 	function add_freeform( $length = null ) {
 		$length = $length ? $length : strlen( $this->document ) - $this->offset;
 		if ( 0 === $length ) {
 			return;
 		}
-		$this->output[] = (array) self::freeform( substr( $this->document, $this->offset, $length ) );
+		$this->output[] = (array) $this->freeform( substr( $this->document, $this->offset, $length ) );
 	}
 	/**
 	 * Given a block structure from memory pushes
 	 * a new block to the output list.
 	 *
 	 * @internal
-	 * @since 3.8.0
+	 * @since 5.0.0
 	 * @param WP_Block_Parser_Block $block        The block to add to the output.
 	 * @param int                   $token_start  Byte offset into the document where the first token for the block starts.
 	 * @param int                   $token_length Byte length of entire block from start of opening token to end of closing token.
 	 * @param int|null              $last_offset  Last byte offset into document if continuing form earlier output.
 	 */
 	/**
 	 * Pushes the top block from the parsing stack to the output list.
 	 *
 	 * @internal
-	 * @since 3.8.0
+	 * @since 5.0.0
 	 * @param int|null $end_offset byte offset into document for where we should stop sending text output as HTML.
 	 */
 	function add_block_from_stack( $end_offset = null ) {
 		$stack_top   = array_pop( $this->stack );
 		$prev_offset = $stack_top->prev_offset;
 			$stack_top->block->innerHTML     .= $html;
 			$stack_top->block->innerContent[] = $html;
 		}
 		if ( isset( $stack_top->leading_html_start ) ) {
-			$this->output[] = (array) self::freeform(
+			$this->output[] = (array) $this->freeform(
 				substr(
 					$this->document,
 					$stack_top->leading_html_start,
 					$stack_top->token_start - $stack_top->leading_html_start
 				)

changeset 18	be944660c56a
parent 9	177826044cd9
child 21	48c4eec2b7e6