Page Menu
Home
WickedGov Phorge
Search
Configure Global Search
Log In
Files
F7399213
TokenList.php
No One
Temporary
Actions
Download File
Edit File
Delete File
View Transforms
Subscribe
Flag For Later
Award Token
Size
3 KB
Referenced Files
None
Subscribers
None
TokenList.php
View Options
<?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
Details
Attached
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)
Attached To
Mode
rMWPROD MediaWiki Production
Attached
Detach File
Event Timeline
Log In to Comment