atk4/ui

<?php

declare(strict_types=1);

namespace Atk4\Ui;

/**
 * Vertically distributed columns based on CSS Grid system.
 */
class Columns extends View
{
    public $ui = 'grid';

    /**
     * Explicitly specify the width of all columns. Normally that's 16, but
     * Fomantic-UI allows you to override with 5 => "ui five column grid".
     *
     * @var int|null
     */
    public $width;

    /** @var int|false Sum of all column widths added so far. */
    protected $calculatedWidth = 0;

    /** @var array<positive-int, string> */
    protected $cssWideClasses = [
        1 => 'one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine',
        'ten', 'eleven', 'twelve', 'thirteen', 'fourteen', 'fifteen', 'sixteen',
    ];

    /**
     * Add new vertical column.
     *
     * @param int|array<mixed> $defaults specify width (1..16) or relative to $width
     *
     * @return View
     */
    public function addColumn($defaults = [])
    {
        if (!is_array($defaults)) {
            $defaults = [$defaults];
        }

        $size = $defaults[0] ?? null;
        unset($defaults[0]);

        $column = View::addTo($this, $defaults);

        if ($size && isset($this->cssWideClasses[$size])) {
            $column->addClass($this->cssWideClasses[$size] . ' wide');
            $this->calculatedWidth = false;
        } elseif ($this->calculatedWidth !== false) {
            ++$this->calculatedWidth;
        }
        $column->addClass('column');

        return $column;
    }

    /**
     * Adds a new row to your grid system. You can specify width of this row
     * which will default to 16.
     *
     * @param int $width
     *
     * @return self
     */
    public function addRow($width = null)
    {
        return static::addTo($this, [$width, 'ui' => false])->addClass('row');
    }

    #[\Override]
    protected function renderView(): void
    {
        $width = $this->width ?? $this->calculatedWidth;
        if ($this->content) {
            $this->addClass($this->content);
            $this->content = null;
        }

        if (isset($this->cssWideClasses[$width])) {
            $this->addClass($this->cssWideClasses[$width] . ' column');
        }

        parent::renderView();
    }
}