DatePicker.php

<?php

namespace A17\Twill\Services\Forms\Fields;

use A17\Twill\Services\Forms\Fields\Traits\HasPlaceholder;
use A17\Twill\Services\Forms\Fields\Traits\IsTranslatable;

class DatePicker extends BaseFormField
{
    use IsTranslatable;
    use HasPlaceholder;

    protected bool $withTime = true;

    protected bool $allowInput = false;

    protected bool $allowClear = false;

    protected bool $timeOnly = false;

    protected bool $time24Hr = false;

    protected ?string $altFormat = null;

    protected ?int $minuteIncrement = null;

    protected ?int $hourIncrement = null;

    public static function make(): static
    {
        return new self(
            component: \A17\Twill\View\Components\Fields\DatePicker::class,
            mandatoryProperties: ['name', 'label']
        );
    }

    /**
     * Hides the time picker.
     */
    public function withoutTime(bool $withoutTime = true): static
    {
        $this->withTime = !$withoutTime;

        return $this;
    }

    /**
     * Allows manual input.
     */
    public function allowInput(bool $allowInput = true): static
    {
        $this->allowInput = $allowInput;

        return $this;
    }

    /**
     * Allows to clear the input field.
     */
    public function allowClear(bool $allowClear = true): static
    {
        $this->allowClear = $allowClear;

        return $this;
    }

    /**
     * Makes it a time picker only.
     */
    public function timeOnly(bool $timeOnly = true): static
    {
        $this->withTime = true;
        $this->timeOnly = $timeOnly;
        $this->altFormat = $this->altFormat ?? (($this->time24Hr ?? false) ? 'H:i' : 'h:i K');

        return $this;
    }

    /**
     * If 24h format should be used.
     */
    public function time24h(bool $time24h = true): static
    {
        $this->time24Hr = $time24h;

        return $this;
    }

    /**
     * If 24h format should be used.
     * Added for docs and backwards compatibility
     */
    public function time24hr(bool $time24hr = true): static
    {
        $this->time24Hr = $time24hr;

        return $this;
    }

    /**
     * Define a custom date format.
     */
    public function altFormat(string $altFormat): static
    {
        $this->altFormat = $altFormat;

        return $this;
    }

    /**
     * Set how many hours are increment when using the + and - actions.
     */
    public function hourIncrement(int $hourIncrement = 1): static
    {
        $this->hourIncrement = $hourIncrement;

        return $this;
    }

    /**
     * Set how many minutes are increment when using the + and - actions.
     */
    public function minuteIncrement(int $minuteIncrement = 1): static
    {
        $this->minuteIncrement = $minuteIncrement;

        return $this;
    }
}