TableButton.php

<?php

declare(strict_types=1);

/*
 * This file is part of the Alight package.
 *
 * (c) June So <june@alight.cc>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Alight\Admin;

use Alight\Admin;

class TableButton
{
    /**
     * Define the configuration index
     *
     */
    public function __construct(private readonly int $index, string $form)
    {
        $defaultUrl = '';
        if ($_SERVER['REQUEST_URI'] ?? '') {
            $defaultUrl = substr($_SERVER['REQUEST_URI'], 0, strrpos($_SERVER['REQUEST_URI'], '/')) . '/form';
        }
        
        Table::$config['button'][$this->index] = [
            'form' => $form,
            'title' => $form,
            'url' => $defaultUrl ?: Admin::url(),
            'action' => 'form',
            'place' => '_column',
        ];

    }

    /**
     * Set click action
     *
     * @param string $value Table::ACTION_*
     */
    public function action(string $value): static
    {
        Table::$config['button'][$this->index][__FUNCTION__] = $value;
        return $this;
    }

    /**
     * Put in the batch bar
     * 
     */
    public function batch(): static
    {
        Table::$config['button'][$this->index]['place'] = '_' . __FUNCTION__;
        Table::$config['button'][$this->index]['action'] = 'confirm';
        return $this;
    }

    /**
     * Set color
     *
     * @param string $color Table::COLOR_*
     */
    public function color(string $color): static
    {
        Table::$config['button'][$this->index][__FUNCTION__] = $color;
        return $this;
    }

    /**
     * Put in the specified column (Create _column column by default)
     *
     */
    public function column(string $columnKey = '_column'): static
    {
        if ($columnKey) {
            if ($columnKey !== '_column') {
                $columnKey = '_column_' . $columnKey;
            }

            Table::$config['button'][$this->index]['place'] = $columnKey;
        }

        return $this;
    }

    /**
     * Put in the specified expand column (Create _expand column by default)
     *
     */
    public function expand(string $columnKey = '_expand'): static
    {
        if ($columnKey) {
            if ($columnKey !== '_expand') {
                $columnKey = '_expand_' . $columnKey;
            }

            Table::$config['button'][$this->index]['place'] = $columnKey;
        }

        return $this;
    }

    /**
     * Set display conditions
     *
     * @param array<string, mixed> $keyValues
     */
    public function if(array $keyValues): static
    {
        Table::$config['button'][$this->index][__FUNCTION__] = $keyValues;
        return $this;
    }

    /**
     * Set request parameters
     *
     * @param array<string, mixed> $keyValues Use {{column_key}} placeholders for column data.
     */
    public function param(array $keyValues): static
    {
        Table::$config['button'][$this->index][__FUNCTION__] = $keyValues;
        return $this;
    }

    /**
     * Which role has permission to view
     *
     * @param list<int> $roleValues
     */
    public function role(array $roleValues): static
    {
        Table::$config['button'][$this->index][__FUNCTION__] = $roleValues;
        return $this;
    }

    /**
     * Set title
     *
     */
    public function title(string $value): static
    {
        Table::$config['button'][$this->index][__FUNCTION__] = $value;
        if (str_starts_with($value, ':')) {
            Table::$config['button'][$this->index]['locale'] = true;
        }

        return $this;
    }

    /**
     * Put in the toolbar
     * 
     */
    public function toolbar(): static
    {
        Table::$config['button'][$this->index]['place'] = '_' . __FUNCTION__;
        return $this;
    }

    /**
     * Set url
     *
     */
    public function url(string $value): static
    {
        Table::$config['button'][$this->index][__FUNCTION__] = Admin::url($value);
        return $this;
    }

    /**
     * Set variant
     *
     * @param string $value Table::VARIANT_*
     *
     * @see https://ant.design/components/button/
     */
    public function variant(string $value): static
    {
        Table::$config['button'][$this->index][__FUNCTION__] = $value;
        return $this;
    }
}