mirror of
https://github.com/WordPress/WordPress.git
synced 2024-08-25 15:22:53 +02:00
Updates the internal representation of the text span coordinates. The mixture of (offset, length) and (start, end) coordinates becomes confusing, this commit replaces it with a (offset, length) pair. There should be no functional or behavioral changes in this patch. For the internal helper classes this patch introduces breaking changes, but those classes are marked private and should not be used outside of the HTML API itself. Props dmsnell. Fixes #59993. Built from https://develop.svn.wordpress.org/trunk@57179 git-svn-id: http://core.svn.wordpress.org/trunk@56690 1a063a9b-81f0-0310-95a4-ce76da25c4cd
65 lines
1.4 KiB
PHP
65 lines
1.4 KiB
PHP
<?php
|
|
/**
|
|
* HTML API: WP_HTML_Text_Replacement class
|
|
*
|
|
* @package WordPress
|
|
* @subpackage HTML-API
|
|
* @since 6.2.0
|
|
*/
|
|
|
|
/**
|
|
* Core class used by the HTML tag processor as a data structure for replacing
|
|
* existing content from start to end, allowing to drastically improve performance.
|
|
*
|
|
* This class is for internal usage of the WP_HTML_Tag_Processor class.
|
|
*
|
|
* @access private
|
|
* @since 6.2.0
|
|
* @since 6.5.0 Replace `end` with `length` to more closely match `substr()`.
|
|
*
|
|
* @see WP_HTML_Tag_Processor
|
|
*/
|
|
class WP_HTML_Text_Replacement {
|
|
/**
|
|
* Byte offset into document where replacement span begins.
|
|
*
|
|
* @since 6.2.0
|
|
*
|
|
* @var int
|
|
*/
|
|
public $start;
|
|
|
|
/**
|
|
* Byte length of span being replaced.
|
|
*
|
|
* @since 6.5.0
|
|
*
|
|
* @var int
|
|
*/
|
|
public $length;
|
|
|
|
/**
|
|
* Span of text to insert in document to replace existing content from start to end.
|
|
*
|
|
* @since 6.2.0
|
|
*
|
|
* @var string
|
|
*/
|
|
public $text;
|
|
|
|
/**
|
|
* Constructor.
|
|
*
|
|
* @since 6.2.0
|
|
*
|
|
* @param int $start Byte offset into document where replacement span begins.
|
|
* @param int $length Byte length of span in document being replaced.
|
|
* @param string $text Span of text to insert in document to replace existing content from start to end.
|
|
*/
|
|
public function __construct( $start, $length, $text ) {
|
|
$this->start = $start;
|
|
$this->length = $length;
|
|
$this->text = $text;
|
|
}
|
|
}
|