Yiisoft\Form\Field\Base\BaseField

Complexity

Total Complexity

21

Size/Duplication

Total Lines	128
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes

0

11 Methods

Rating	Name	Duplication	Size	Complexity
A	useContainer()	0	5	1
A	containerTag()	0	9	2
A	containerTagAttributes()	0	5	1
A	renderEnd()	0	14	3
A	beforeRender()	0	2	1
A	generateBeginContent()	0	3	1
A	generateEndContent()	0	3	1
A	run()	0	21	4
A	renderOpenContainerAndContent()	0	16	4
A	prepareContainerTagAttributes()	0	2	1
A	begin()	0	15	2

<?php

declare(strict_types=1);

namespace Yiisoft\Form\Field\Base;

use InvalidArgumentException;
use Yiisoft\Html\Html;
use Yiisoft\Html\Tag\CustomTag;
use Yiisoft\Widget\Widget;

abstract class BaseField extends Widget
{
    /**
     * @psalm-var non-empty-string
     */
    protected string $containerTag = 'div';
    protected array $containerTagAttributes = [];
    protected bool $useContainer = true;

    private bool $isStartedByBegin = false;

    final public function containerTag(string $tag): static
    {
        if ($tag === '') {
            throw new InvalidArgumentException('Tag name cannot be empty.');
        }

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

    final public function containerTagAttributes(array $attributes): static
    {
        $new = clone $this;
        $new->containerTagAttributes = $attributes;
        return $new;
    }

    final public function useContainer(bool $use): static
    {
        $new = clone $this;
        $new->useContainer = $use;
        return $new;
    }

    final public function begin(): ?string
    {
        parent::begin();
        $this->isStartedByBegin = true;

        $this->beforeRender();

        $content = $this->generateBeginContent();

        $html = $this->renderOpenContainerAndContent($content);
        if ($html === '') {
            return '';
        }

        return $html . "\n";
    }

    final protected function run(): string
    {
        if ($this->isStartedByBegin) {
            $this->isStartedByBegin = false;
            return $this->renderEnd();
        }

        $this->beforeRender();

        $content = $this->generateContent();
        if ($content === null) {
            return '';
        }

        $result = $this->renderOpenContainerAndContent($content);

        if ($this->useContainer) {
            $result .= "\n" . Html::closeTag($this->containerTag);
        }

        return $result;
    }

    protected function beforeRender(): void
    {
    }

    abstract protected function generateContent(): ?string;

    protected function generateBeginContent(): string
    {
        return '';
    }

    protected function generateEndContent(): string
    {
        return '';
    }

    protected function prepareContainerTagAttributes(array &$attributes): void
    {
    }

    private function renderEnd(): string
    {
        $content = $this->generateEndContent();

        if (!$this->useContainer) {
            return $content;
        }

        $containerTag = CustomTag::name($this->containerTag);

        return
            "\n"
            . ($content !== '' ? $content . "\n" : '')
            . $containerTag->close();
    }

    private function renderOpenContainerAndContent(string $content): string
    {
        if (!$this->useContainer) {
            return $content;
        }

        $containerTag = CustomTag::name($this->containerTag);

        $attributes = $this->containerTagAttributes;
        $this->prepareContainerTagAttributes($attributes);
        if ($attributes !== []) {
            $containerTag = $containerTag->attributes($attributes);
        }

        return $containerTag->open()
            . ($content === '' ? '' : ("\n" . $content));
    }
}