royallthefourth / html-document

src/Element/Link.php

<?php

namespace RoyallTheFourth\HtmlDocument\Element;

use RoyallTheFourth\HtmlDocument\Attribute\BooleanAttribute;
use RoyallTheFourth\HtmlDocument\Attribute\StandardAttribute;
use RoyallTheFourth\HtmlDocument\Set\AttributeSet;
use RoyallTheFourth\HtmlDocument\Tag\EmptyTag;

/**
 * Class Link
 * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/link
 */
final class Link extends AbstractElement
{
    public function __construct(AttributeSet $attributes = null)
    {
        $this->attributes = $attributes ?? new AttributeSet();
        $this->tag = new EmptyTag('link', $attributes);
    }

    public function withAttribute(string $name, string $value = null): Link
    {
        if ($value) {

The expression $value of type null|string is loosely compared to true; this is ambiguous if the string can be empty. You might want to explicitly use !== null instead.

            $attribute = new StandardAttribute($name, $value);
        } else {
            $attribute = new BooleanAttribute($name);
        }

        return new Link($this->attributes->add($attribute));
    }

    public function withCrossOrigin(string $policy): Link
    {
        return $this->withAttribute('crossorigin', $policy);
    }

    public function withHref(string $url): Link
    {
        return $this->withAttribute('href', $url);
    }

    public function withHrefLang(string $language): Link
    {
        return $this->withAttribute('hreflang', $language);
    }

    /**
     * @param string $mediaQuery
     * @return Link
     * @see https://developer.mozilla.org/en-US/docs/Web/CSS/Media_Queries/Using_media_queries
     */
    public function withMedia(string $mediaQuery): Link
    {
        return $this->withAttribute('media', $mediaQuery);
    }

    /**
     * @param string $linkType
     * @return Link
     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Link_types
     */
    public function withRel(string $linkType): Link
    {
        return $this->withAttribute('rel', $linkType);
    }

    public function withSizes(string $sizes = 'any'): Link
    {
        return $this->withAttribute('sizes', $sizes);
    }

    public function withType(string $mime): Link
    {
        return $this->withAttribute('type', $mime);
    }
}