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

Lookup

class Lookup extends Input

Lookup component.

Extends Input component to provide autocomplete/lookup functionality.

Traits

HasPresets

Trait HasPresets.

HasErrorBag

Trait HasErrorBag.

Properties

$size from  Input
$color from  Input
string|null $label

Label text.
$placeholder from  Input
$type from  Input
$hasError from  InputBase
$iconStart from  Input
$iconStartSvg from  Input
$iconEnd from  Input
$iconEndSvg from  Input
$copyButton from  Input
$clearable from  Input
$help from  Input
$showPasswordToggle from  Input
$customError from  Input
$value from  Input
$hint from  Input
$spinner from  Input
array $options

List of options.
string $optionLabel

Property name for option label.
string $optionValue

Property name for option value.

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(array $options = [], string $optionLabel = "name", string $optionValue = "id", string|null $label = null)

Create a new Lookup 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
normalizeOptions(array $options)

Normalize options into a standard 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 46
__construct(array $options = [], string $optionLabel = "name", string $optionValue = "id", string|null $label = null)

Create a new Lookup component instance.

Parameters

array $options

Options array.
string $optionLabel

Label key.
string $optionValue

Value key.
string|null $label

Label text.

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 103
View|Closure|string render()

Get the view / contents that represent the component.

Return Value

View|Closure|string

at line 65
array normalizeOptions(array $options)

Normalize options into a standard format.

Supports simple arrays, arrays of objects/arrays, and single key-value pairs.

Parameters

array $options

Raw options.

Return Value

array

Normalized options.