Page MenuHomeWickedGov Phorge

TokenList.php
No OneTemporary

Size
3 KB
Referenced Files
None
Subscribers
None

TokenList.php

<?php
declare( strict_types = 1 );
namespace Wikimedia\Parsoid\Utils\DOMCompat;
use Iterator;
use LogicException;
use Wikimedia\Parsoid\DOM\Element;
use Wikimedia\Parsoid\Utils\DOMCompat;
/**
* Implements the parts of DOMTokenList interface which are used by Parsoid.
* @note To improve performance, no effort is made to keep the TokenList in sync
* with the real class list if that is changed from elsewhere.
* @see https://dom.spec.whatwg.org/#interface-domtokenlist
*/
class TokenList implements Iterator {
/** @var Element The node whose classes are listed. */
protected $node;
/** @var string|bool Copy of the attribute text, used for change detection. */
private $attribute = false;
// Testing element existence with a list is less painful than returning numeric keys
// with a map, so let's go with that.
/** @var string[] */
private $classList;
/**
* @param Element $node The node whose classes are listed.
*/
public function __construct( $node ) {
$this->node = $node;
$this->lazyLoadClassList();
}
/**
* Return the number of CSS classes this element has.
* @return int
* @see https://dom.spec.whatwg.org/#dom-domtokenlist-length
*/
public function getLength(): int {
$this->lazyLoadClassList();
return count( $this->classList );
}
/**
* Checks if the element has a given CSS class.
* @param string $token
* @return bool
* @see https://dom.spec.whatwg.org/#dom-domtokenlist-contains
*/
public function contains( string $token ): bool {
$this->lazyLoadClassList();
return in_array( $token, $this->classList, true );
}
/**
* Add CSS classes to the element.
* @param string ...$tokens List of classes to add
* @see https://dom.spec.whatwg.org/#dom-domtokenlist-add
*/
public function add( string ...$tokens ): void {
$this->lazyLoadClassList();
$changed = false;
foreach ( $tokens as $token ) {
if ( !in_array( $token, $this->classList, true ) ) {
$changed = true;
$this->classList[] = $token;
}
}
if ( $changed ) {
$this->saveClassList();
}
}
/**
* Remove CSS classes from the element.
* @param string ...$tokens List of classes to remove
* @see https://dom.spec.whatwg.org/#dom-domtokenlist-remove
*/
public function remove( string ...$tokens ): void {
$this->lazyLoadClassList();
$changed = false;
foreach ( $tokens as $token ) {
$index = array_search( $token, $this->classList, true );
if ( $index !== false ) {
array_splice( $this->classList, $index, 1 );
$changed = true;
}
}
if ( $changed ) {
$this->saveClassList();
}
}
public function current(): string {
$this->lazyLoadClassList();
return current( $this->classList );
}
public function next(): void {
$this->lazyLoadClassList();
next( $this->classList );
}
public function key(): ?int {
$this->lazyLoadClassList();
return key( $this->classList );
}
public function valid(): bool {
$this->lazyLoadClassList();
return key( $this->classList ) !== null;
}
public function rewind(): void {
$this->lazyLoadClassList();
reset( $this->classList );
}
/**
* Set the classList property based on the class attribute of the wrapped element.
*/
private function lazyLoadClassList(): void {
$attrib = DOMCompat::getAttribute( $this->node, 'class' ) ?? '';
if ( $attrib !== $this->attribute ) {
$this->attribute = $attrib;
$this->classList = preg_split( '/\s+/', $attrib, -1,
PREG_SPLIT_NO_EMPTY );
}
}
/**
* Set the class attribute of the wrapped element based on the classList property.
*/
private function saveClassList(): void {
if ( $this->classList === null ) {
throw new LogicException( 'no class list to set' );
} elseif ( $this->classList === [] ) {
$this->attribute = '';
$this->node->removeAttribute( 'class' );
} else {
$this->attribute = implode( ' ', $this->classList );
$this->node->setAttribute( 'class', $this->attribute );
}
}
}

File Metadata

Mime Type
text/x-php
Expires
Sat, Nov 21, 15:50 (1 d, 9 m ago)
Storage Engine
local-disk
Storage Format
Raw Data
Storage Handle
c5/46/6873f05823a5a405001603fe6915
Default Alt Text
TokenList.php (3 KB)

Event Timeline