1. class
  2. Beartropy
  3. \
  4. Ui
  5. \
  6. Components
  7. \
  8. Select

Select

class Select extends InputTriggerBase

Select Component.

A powerful select input supporting arrays, Eloquent collections, remote search, and object mapping.

Traits

HasPresets

Trait HasPresets.

HasErrorBag

Trait HasErrorBag.

Properties

$size
$color
$label
$placeholder
$type from  InputTriggerBase
$hasError from  InputTriggerBase
$name from  InputTriggerBase
$disabled from  InputTriggerBase
$options
$selected
$icon
$searchable
$multiple
$clearable
$remote
$remoteUrl
$initialValue
$perPage
$customError
$hint
string|null $optionLabel

Field map for option label.
string|null $optionValue

Field map for option value.
string|null $optionDescription

Field map for option description.
string|null $optionIcon

Field map for option icon.
string|null $optionAvatar

Field map for option avatar.
$autosave
$autosaveMethod
$autosaveKey
$autosaveDebounce
$emptyMessage
$isEmpty
$spinner

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($options = null, $selected = null, $icon = null, string|null $placeholder = 'Seleccionar...', $searchable = true, string|null $label = null, $multiple = false, $clearable = true, $remote = false, $remoteUrl = null, string|null $size = null, string|null $color = null, $initialValue = null, $perPage = 15, $customError = null, $hint = null, $autosave = false, $autosaveMethod = 'savePreference', $autosaveKey = null, $autosaveDebounce = 300, $optionLabel = 'label', $optionValue = 'value', $optionDescription = 'description', $optionIcon = 'icon', $optionAvatar = 'avatar', $emptyMessage = 'No se encontraron opciones', $spinner = true)

Create a new Select 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.

array<string,array{_value: mixed, label: string|null, icon: string|null, avatar: string|null, description: string|null}>
normalizeOptions(mixed $options)

Normalize options into a standard array format.

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 111
__construct($options = null, $selected = null, $icon = null, string|null $placeholder = 'Seleccionar...', $searchable = true, string|null $label = null, $multiple = false, $clearable = true, $remote = false, $remoteUrl = null, string|null $size = null, string|null $color = null, $initialValue = null, $perPage = 15, $customError = null, $hint = null, $autosave = false, $autosaveMethod = 'savePreference', $autosaveKey = null, $autosaveDebounce = 300, $optionLabel = 'label', $optionValue = 'value', $optionDescription = 'description', $optionIcon = 'icon', $optionAvatar = 'avatar', $emptyMessage = 'No se encontraron opciones', $spinner = true)

Create a new Select component instance.

Parameters

$options
$selected
$icon
string|null $placeholder Placeholder.
$searchable
string|null $label Label.
$multiple
$clearable
$remote
$remoteUrl
string|null $size

Component size.
string|null $color

Component color.
$initialValue
$perPage
$customError
$hint
$autosave
$autosaveMethod
$autosaveKey
$autosaveDebounce
$optionLabel
$optionValue
$optionDescription
$optionIcon
$optionAvatar
$emptyMessage
$spinner

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:

  1. Explicit $this->size.
  2. Magic attributes (e.g., <x-button sm />).
  3. 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 337
View|Closure|string render()

Get the view / contents that represent the component.

Return Value

View|Closure|string

at line 201
protected array<string,array{_value: mixed, label: string|null, icon: string|null, avatar: string|null, description: string|null}> normalizeOptions(mixed $options)

Normalize options into a standard array format.

Handles:

  • Eloquent Collections.
  • Associative arrays (key => label).
  • Indexed arrays.
  • Array of Options (objects/arrays).

Uses configured field mappings (optionLabel, optionValue) to extract data.

Parameters

mixed $options

Raw options data.

Return Value

array<string,array{_value: mixed, label: string|null, icon: string|null, avatar: string|null, description: string|null}>