Beartropy\Ui\Components\Datetime

class Datetime extends BeartropyComponent

Datetime component.

Renders a date/time picker using flatpickr.

Traits

HasPresets

Trait HasPresets.

HasErrorBag

Trait HasErrorBag.

Properties

string\|null	$size	Component size (md, lg, etc.) used for preset resolution.	from BeartropyComponent
string\|null	$name	Input name.
string\|null	$label	Input label.
mixed	$value	Initial value.
string\|null	$min	Minimum date.
string\|null	$max	Maximum date.
bool	$disabled	Disabled state.
bool	$readonly	Readonly state.
string\|null	$placeholder	Placeholder text.
string\|null	$hint	Hint text.
string\|null	$customError	Custom error message.
string	$locale	Locale setting.
bool	$range	Enable range mode.
mixed	$initialValue	Initial value override.
string	$format	Date format (PHP format).
string\|null	$formatDisplay	Display format (JS format).
bool	$showTime	Enable time picker.
string\|null	$color	Input color.

Methods

array{0: array, 1: array, 2: bool, 3: array}

getComponentPresets(string|null $componentName = null, ComponentAttributeBag|null $attributes = null)

compute component presets based on context.

from HasPresets

array

loadPresets(string $componentName)

No description

from HasPresets

array

loadComponentDefaults(string $componentName)

No description

from HasPresets

bool

detectHasVariants(array $colors)

No description

from HasPresets

array

computeSupports(array $sizes, array $colorsArray, array $defaults, array $magicProps)

No description

from HasPresets

array

resolveSize(array $supports, array $sizes, array $defaults, array $magicProps)

No description

from HasPresets

array

resolveVariant(array $supports, array $colorsArray, array $componentPresets, array $defaults, array $magicProps, bool $hasVariants)

No description

from HasPresets

array

resolveColor(array $supports, array $colorsArray, array $componentPresets, array $defaults, array $magicProps, string|null $variant, bool $hasVariants)

No description

from HasPresets

array

resolveFill(array $supports, array $attributes, array $defaults)

No description

from HasPresets

string

buildCacheKey(string $component, array $supports, string|null $size, string|null $variant, string|null $color, bool $shouldFill)

No description

from HasPresets

void

syncInstanceProps(array $supports, string|null $size, string|null $variant, string|null $color)

No description

from HasPresets

array

buildPresetNames(array $supports, string|null $size, string|null $variant, string|null $color, bool $shouldFill, string $sizeOrigin, string $variantOrigin, string $colorOrigin, string $fillOrigin)

No description

from HasPresets

void

debugWarnings(array $supports, array $sizePreset, array $colorPreset, string $componentName, string|null $variant, string|null $color)

No description

from HasPresets

array{__bt_wireModel: string|null, __bt_finalError: string|null, __bt_hasError: bool}

getErrorState(string|null $error = null, ComponentAttributeBag|null $attributes = null, MessageBag|null $errors = null)

Retrieve the error state for a given attribute or context.

from HasErrorBag

__construct(string|null $name = null, string|null $label = null, mixed $value = null, string|null $min = null, string|null $max = null, bool $disabled = false, bool $readonly = false, string|null $placeholder = null, string|null $hint = null, string|null $customError = null, string $locale = 'es', bool $range = false, mixed $initialValue = null, string $format = 'Y-m-d', string|null $formatDisplay = null, bool $showTime = false, string|null $color = null)

Create a new Datetime component instance.

array{0: bool, 1: string|null, 2: bool, 3: string|null}

getWireModelState(ComponentAttributeBag|null $attributes = null)

Analyze wire:model attributes to determine binding state.

from BeartropyComponent

array<string,mixed>

getComponentSizePreset(string|null $componentName = null, ComponentAttributeBag|null $attributes = null)

Get the size preset configuration.

from BeartropyComponent

array<string,mixed>

getSizePreset(string|null $componentName = null, ComponentAttributeBag|array|null $attributes = null, string $defaultSize = 'md')

Resolve the size preset for the component.

from BeartropyComponent

array<string,mixed>

getColorPreset(string $component, string|null $color = null, string|null $variant = null)

Resolve the color preset configuration.

from BeartropyComponent

View|Closure|string

render()

Get the view / contents that represent the component.

Details

in HasPresets at line 22
`array{0: array, 1: array, 2: bool, 3: array} getComponentPresets(string|null $componentName = null, ComponentAttributeBag|null $attributes = null)`

compute component presets based on context.

Parameters

string\|null	$componentName	Component key.
ComponentAttributeBag\|null	$attributes	Attributes bag.

Return Value

array{0: array, 1: array, 2: bool, 3: array}

[colorPreset, sizePreset, shouldFill, presetNames]

in HasPresets at line 64
`protected array loadPresets(string $componentName)`

No description

Parameters

string

$componentName

Return Value

array

in HasPresets at line 75
`protected array loadComponentDefaults(string $componentName)`

No description

Parameters

string

$componentName

Return Value

array

in HasPresets at line 88
`protected bool detectHasVariants(array $colors)`

No description

Parameters

array

$colors

Return Value

bool

in HasPresets at line 100
`protected array computeSupports(array $sizes, array $colorsArray, array $defaults, array $magicProps)`

No description

Parameters

array	$sizes
array	$colorsArray
array	$defaults
array	$magicProps

Return Value

array

in HasPresets at line 118
`protected array resolveSize(array $supports, array $sizes, array $defaults, array $magicProps)`

No description

Parameters

array	$supports
array	$sizes
array	$defaults
array	$magicProps

Return Value

array

in HasPresets at line 149
`protected array resolveVariant(array $supports, array $colorsArray, array $componentPresets, array $defaults, array $magicProps, bool $hasVariants)`

No description

Parameters

array	$supports
array	$colorsArray
array	$componentPresets
array	$defaults
array	$magicProps
bool	$hasVariants

Return Value

array

in HasPresets at line 193
`protected array resolveColor(array $supports, array $colorsArray, array $componentPresets, array $defaults, array $magicProps, string|null $variant, bool $hasVariants)`

No description

Parameters

array	$supports
array	$colorsArray
array	$componentPresets
array	$defaults
array	$magicProps
string\|null	$variant
bool	$hasVariants

Return Value

array

in HasPresets at line 258
`protected array resolveFill(array $supports, array $attributes, array $defaults)`

No description

Parameters

array	$supports
array	$attributes
array	$defaults

Return Value

array

in HasPresets at line 303
`protected string buildCacheKey(string $component, array $supports, string|null $size, string|null $variant, string|null $color, bool $shouldFill)`

No description

Parameters

string	$component
array	$supports
string\|null	$size
string\|null	$variant
string\|null	$color
bool	$shouldFill

Return Value

string

in HasPresets at line 313
`protected void syncInstanceProps(array $supports, string|null $size, string|null $variant, string|null $color)`

No description

Parameters

array	$supports
string\|null	$size
string\|null	$variant
string\|null	$color

Return Value

void

in HasPresets at line 326
`protected array buildPresetNames(array $supports, string|null $size, string|null $variant, string|null $color, bool $shouldFill, string $sizeOrigin, string $variantOrigin, string $colorOrigin, string $fillOrigin)`

No description

Parameters

array	$supports
string\|null	$size
string\|null	$variant
string\|null	$color
bool	$shouldFill
string	$sizeOrigin
string	$variantOrigin
string	$colorOrigin
string	$fillOrigin

Return Value

array

in HasPresets at line 344
`protected void debugWarnings(array $supports, array $sizePreset, array $colorPreset, string $componentName, string|null $variant, string|null $color)`

No description

Parameters

array	$supports
array	$sizePreset
array	$colorPreset
string	$componentName
string\|null	$variant
string\|null	$color

Return Value

void

in HasErrorBag at line 21
`array{__bt_wireModel: string|null, __bt_finalError: string|null, __bt_hasError: bool} getErrorState(string|null $error = null, ComponentAttributeBag|null $attributes = null, MessageBag|null $errors = null)`

Retrieve the error state for a given attribute or context.

Parameters

string\|null	$error	Direct error message.
ComponentAttributeBag\|null	$attributes	Component attributes.
MessageBag\|null	$errors	Global errors.

Return Value

array{__bt_wireModel: string|null, __bt_finalError: string|null, __bt_hasError: bool}

at line 71
`__construct(string|null $name = null, string|null $label = null, mixed $value = null, string|null $min = null, string|null $max = null, bool $disabled = false, bool $readonly = false, string|null $placeholder = null, string|null $hint = null, string|null $customError = null, string $locale = 'es', bool $range = false, mixed $initialValue = null, string $format = 'Y-m-d', string|null $formatDisplay = null, bool $showTime = false, string|null $color = null)`

Create a new Datetime component instance.

Parameters

string\|null	$name	Input name.
string\|null	$label	Input label.
mixed	$value	Initial value.
string\|null	$min	Minimum date.
string\|null	$max	Maximum date.
bool	$disabled	Disabled state.
bool	$readonly	Readonly state.
string\|null	$placeholder	Placeholder text.
string\|null	$hint	Hint text.
string\|null	$customError	Custom error message.
string	$locale	Locale setting.
bool	$range	Enable range mode.
mixed	$initialValue	Initial value override.
string	$format	Date format (PHP format).
string\|null	$formatDisplay	Display format (JS format).
bool	$showTime	Enable time picker.
string\|null	$color	Input color. Blade Props Slots

in BeartropyComponent at line 65
`array{0: bool, 1: string|null, 2: bool, 3: string|null} getWireModelState(ComponentAttributeBag|null $attributes = null)`

Analyze wire:model attributes to determine binding state.

Detects if wire:model is present and if it uses dot notation (e.g., user.name).

Parameters

ComponentAttributeBag|null

$attributes

Component attributes.

Return Value

array{0: bool, 1: string|null, 2: bool, 3: string|null}

[hasWireModel, wireModelValue, hasDotNotation, parsedDotNotationValue]

in BeartropyComponent at line 92
`array<string,mixed> getComponentSizePreset(string|null $componentName = null, ComponentAttributeBag|null $attributes = null)`

Get the size preset configuration.

Legacy method for size resolution. Prioritizes size property, then magic attributes.

Parameters

string\|null	$componentName	UNUSED.
ComponentAttributeBag\|null	$attributes	Component attributes to check for magic props.

Return Value

array<string,mixed>

The size configuration array.

in BeartropyComponent at line 133
`array<string,mixed> getSizePreset(string|null $componentName = null, ComponentAttributeBag|array|null $attributes = null, string $defaultSize = 'md')`

Resolve the size preset for the component.

Checks:

Explicit $this->size.
Magic attributes (e.g., <x-button sm />).
Default size.

Parameters

string\|null	$componentName	Component name (used for context, optionally).
ComponentAttributeBag\|array\|null	$attributes	Attributes array or bag.
string	$defaultSize	Default size key (default: 'md').

Return Value

array<string,mixed>

The resolved size preset configuration.

in BeartropyComponent at line 167
`array<string,mixed> getColorPreset(string $component, string|null $color = null, string|null $variant = null)`

Resolve the color preset configuration.

Handles color resolution based on component config, variants, and defaults.

Parameters

string	$component	Component key in configuration (e.g., 'button').
string\|null	$color	Explicit color name.
string\|null	$variant	Variant name (e.g., 'solid', 'outline').

Return Value

array<string,mixed>

The color configuration/classes.

at line 98
`View|Closure|string render()`

Get the view / contents that represent the component.

Return Value

View|Closure|string

Datetime

Traits

Properties

Methods

Details

in HasPresets at line 22 array{0: array, 1: array, 2: bool, 3: array} getComponentPresets(string|null $componentName = null, ComponentAttributeBag|null $attributes = null)

Parameters

Return Value

in HasPresets at line 64 protected array loadPresets(string $componentName)

Parameters

Return Value

in HasPresets at line 75 protected array loadComponentDefaults(string $componentName)

Parameters

Return Value

in HasPresets at line 88 protected bool detectHasVariants(array $colors)

Parameters

Return Value

in HasPresets at line 100 protected array computeSupports(array $sizes, array $colorsArray, array $defaults, array $magicProps)

Parameters

Return Value

in HasPresets at line 118 protected array resolveSize(array $supports, array $sizes, array $defaults, array $magicProps)

Parameters

Return Value

in HasPresets at line 149 protected array resolveVariant(array $supports, array $colorsArray, array $componentPresets, array $defaults, array $magicProps, bool $hasVariants)

Parameters

Return Value

in HasPresets at line 193 protected array resolveColor(array $supports, array $colorsArray, array $componentPresets, array $defaults, array $magicProps, string|null $variant, bool $hasVariants)

Parameters

Return Value

in HasPresets at line 258 protected array resolveFill(array $supports, array $attributes, array $defaults)

Parameters

Return Value

in HasPresets at line 303 protected string buildCacheKey(string $component, array $supports, string|null $size, string|null $variant, string|null $color, bool $shouldFill)

Parameters

Return Value

in HasPresets at line 313 protected void syncInstanceProps(array $supports, string|null $size, string|null $variant, string|null $color)

Parameters

Return Value

in HasPresets at line 326 protected array buildPresetNames(array $supports, string|null $size, string|null $variant, string|null $color, bool $shouldFill, string $sizeOrigin, string $variantOrigin, string $colorOrigin, string $fillOrigin)

Parameters

Return Value

in HasPresets at line 344 protected void debugWarnings(array $supports, array $sizePreset, array $colorPreset, string $componentName, string|null $variant, string|null $color)

Parameters

Return Value

in HasErrorBag at line 21 array{__bt_wireModel: string|null, __bt_finalError: string|null, __bt_hasError: bool} getErrorState(string|null $error = null, ComponentAttributeBag|null $attributes = null, MessageBag|null $errors = null)

Parameters

Return Value

Parameters

Blade Props

Slots

in BeartropyComponent at line 65 array{0: bool, 1: string|null, 2: bool, 3: string|null} getWireModelState(ComponentAttributeBag|null $attributes = null)

Parameters

Return Value

in BeartropyComponent at line 92 array<string,mixed> getComponentSizePreset(string|null $componentName = null, ComponentAttributeBag|null $attributes = null)

Parameters

Return Value

in BeartropyComponent at line 133 array<string,mixed> getSizePreset(string|null $componentName = null, ComponentAttributeBag|array|null $attributes = null, string $defaultSize = 'md')

Parameters

Return Value

in BeartropyComponent at line 167 array<string,mixed> getColorPreset(string $component, string|null $color = null, string|null $variant = null)

Parameters

Return Value

at line 98 View|Closure|string render()

Return Value

in HasPresets at line 22
`array{0: array, 1: array, 2: bool, 3: array} getComponentPresets(string|null $componentName = null, ComponentAttributeBag|null $attributes = null)`

in HasPresets at line 64
`protected array loadPresets(string $componentName)`

in HasPresets at line 75
`protected array loadComponentDefaults(string $componentName)`

in HasPresets at line 88
`protected bool detectHasVariants(array $colors)`

in HasPresets at line 100
`protected array computeSupports(array $sizes, array $colorsArray, array $defaults, array $magicProps)`

in HasPresets at line 118
`protected array resolveSize(array $supports, array $sizes, array $defaults, array $magicProps)`

in HasPresets at line 149
`protected array resolveVariant(array $supports, array $colorsArray, array $componentPresets, array $defaults, array $magicProps, bool $hasVariants)`

in HasPresets at line 193
`protected array resolveColor(array $supports, array $colorsArray, array $componentPresets, array $defaults, array $magicProps, string|null $variant, bool $hasVariants)`

in HasPresets at line 258
`protected array resolveFill(array $supports, array $attributes, array $defaults)`

in HasPresets at line 303
`protected string buildCacheKey(string $component, array $supports, string|null $size, string|null $variant, string|null $color, bool $shouldFill)`

in HasPresets at line 313
`protected void syncInstanceProps(array $supports, string|null $size, string|null $variant, string|null $color)`

in HasPresets at line 326
`protected array buildPresetNames(array $supports, string|null $size, string|null $variant, string|null $color, bool $shouldFill, string $sizeOrigin, string $variantOrigin, string $colorOrigin, string $fillOrigin)`

in HasPresets at line 344
`protected void debugWarnings(array $supports, array $sizePreset, array $colorPreset, string $componentName, string|null $variant, string|null $color)`

in HasErrorBag at line 21
`array{__bt_wireModel: string|null, __bt_finalError: string|null, __bt_hasError: bool} getErrorState(string|null $error = null, ComponentAttributeBag|null $attributes = null, MessageBag|null $errors = null)`

in BeartropyComponent at line 65
`array{0: bool, 1: string|null, 2: bool, 3: string|null} getWireModelState(ComponentAttributeBag|null $attributes = null)`

in BeartropyComponent at line 92
`array<string,mixed> getComponentSizePreset(string|null $componentName = null, ComponentAttributeBag|null $attributes = null)`

in BeartropyComponent at line 133
`array<string,mixed> getSizePreset(string|null $componentName = null, ComponentAttributeBag|array|null $attributes = null, string $defaultSize = 'md')`

in BeartropyComponent at line 167
`array<string,mixed> getColorPreset(string $component, string|null $color = null, string|null $variant = null)`

at line 98
`View|Closure|string render()`