Yiisoft\Form\Field\Part\Hint

Complexity

Total Complexity

8

Size/Duplication

Total Lines	85
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes	1
Bugs	0	Features	0

5 Methods

Rating	Name	Duplication	Size	Complexity
A	content()	0	5	1
A	tag()	0	9	2
A	run()	0	14	3
A	tagAttributes()	0	5	1
A	encode()	0	5	1

<?php

declare(strict_types=1);

namespace Yiisoft\Form\Field\Part;

use InvalidArgumentException;
use Stringable;
use Yiisoft\Form\Field\Base\FormAttributeTrait;
use Yiisoft\Html\Html;
use Yiisoft\Widget\Widget;

final class Hint extends Widget
{
    use FormAttributeTrait;

    /**
     * @psalm-var non-empty-string
     */
    private string $tag = 'div';
    private array $attributes = [];

    /**
     * @var string|Stringable|null
     */
    private $content = null;

    private bool $encode = true;

    /**
     * Set the container tag name for the hint.
     *
     * @param string $tag Container tag name. Set to empty value to render error messages without container tag.
     *
     * @return static
     */
    public function tag(string $tag): self
    {
        if ($tag === '') {
            throw new InvalidArgumentException('Tag name cannot be empty.');
        }

        $new = clone $this;
        $new->tag = $tag;
        return $new;
    }

    /**
     * @return static
     */
    public function tagAttributes(array $attributes): self
    {
        $new = clone $this;
        $new->attributes = $attributes;
        return $new;
    }

    /**
     * @param string|Stringable|null $content
     *
     * @return static
     */
    public function content($content): self
    {
        $new = clone $this;
        $new->content = $content;
        return $new;
    }

    /**
     * Whether content should be HTML-encoded.
     *
     * @param bool $value
     *
     * @return static
     */
    public function encode(bool $value): self
    {
        $new = clone $this;
        $new->encode = $value;
        return $new;
    }

    protected function run(): string
    {
        if ($this->content !== null) {
            $content = $this->content;
        } else {
            $content = $this->getAttributeHint();
            if ($content === '') {
                return '';
            }
        }

        return Html::tag($this->tag, $content, $this->attributes)
            ->encode($this->encode)
            ->render();
    }
}