102 lines
2.5 KiB
PHP
102 lines
2.5 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace Sabberworm\CSS\Value;
|
|
|
|
use Sabberworm\CSS\OutputFormat;
|
|
use Sabberworm\CSS\Parsing\ParserState;
|
|
use Sabberworm\CSS\Parsing\SourceException;
|
|
use Sabberworm\CSS\Parsing\UnexpectedEOFException;
|
|
use Sabberworm\CSS\Parsing\UnexpectedTokenException;
|
|
use Sabberworm\CSS\ShortClassNameProvider;
|
|
|
|
/**
|
|
* This class represents URLs in CSS. `URL`s always output in `URL("")` notation.
|
|
*/
|
|
class URL extends PrimitiveValue
|
|
{
|
|
use ShortClassNameProvider;
|
|
|
|
/**
|
|
* @var CSSString
|
|
*/
|
|
private $url;
|
|
|
|
/**
|
|
* @param int<1, max>|null $lineNumber
|
|
*/
|
|
public function __construct(CSSString $url, ?int $lineNumber = null)
|
|
{
|
|
parent::__construct($lineNumber);
|
|
$this->url = $url;
|
|
}
|
|
|
|
/**
|
|
* @throws SourceException
|
|
* @throws UnexpectedEOFException
|
|
* @throws UnexpectedTokenException
|
|
*
|
|
* @internal since V8.8.0
|
|
*/
|
|
public static function parse(ParserState $parserState): URL
|
|
{
|
|
$anchor = $parserState->anchor();
|
|
$identifier = '';
|
|
for ($i = 0; $i < 3; $i++) {
|
|
$character = $parserState->parseCharacter(true);
|
|
if ($character === null) {
|
|
break;
|
|
}
|
|
$identifier .= $character;
|
|
}
|
|
$useUrl = $parserState->streql($identifier, 'url');
|
|
if ($useUrl) {
|
|
$parserState->consumeWhiteSpace();
|
|
$parserState->consume('(');
|
|
} else {
|
|
$anchor->backtrack();
|
|
}
|
|
$parserState->consumeWhiteSpace();
|
|
$result = new URL(CSSString::parse($parserState), $parserState->currentLine());
|
|
if ($useUrl) {
|
|
$parserState->consumeWhiteSpace();
|
|
$parserState->consume(')');
|
|
}
|
|
return $result;
|
|
}
|
|
|
|
public function setURL(CSSString $url): void
|
|
{
|
|
$this->url = $url;
|
|
}
|
|
|
|
public function getURL(): CSSString
|
|
{
|
|
return $this->url;
|
|
}
|
|
|
|
/**
|
|
* @return non-empty-string
|
|
*/
|
|
public function render(OutputFormat $outputFormat): string
|
|
{
|
|
return "url({$this->url->render($outputFormat)})";
|
|
}
|
|
|
|
/**
|
|
* @return array<string, bool|int|float|string|array<mixed>|null>
|
|
*
|
|
* @internal
|
|
*/
|
|
public function getArrayRepresentation(): array
|
|
{
|
|
return [
|
|
'class' => $this->getShortClassName(),
|
|
// We're using the term "uri" here to match the wording used in the specs:
|
|
// https://www.w3.org/TR/CSS22/syndata.html#uri
|
|
'uri' => $this->url->getArrayRepresentation(),
|
|
];
|
|
}
|
|
}
|