name($name); $this->statePath($name); } public static function make(?string $name = null): static { $fieldClass = static::class; $name ??= static::getDefaultName(); if ($name === null) { throw new InvalidArgumentException("Field of class [$fieldClass] must have a unique name, passed to the [make()] method."); } $static = app($fieldClass, ['name' => $name]); $static->configure(); return $static; } protected function setUp(): void { parent::setUp(); $this->setUpHint(); } public static function getDefaultName(): ?string { return null; } /** * @return array */ public function getDefaultStateCasts(): array { $casts = parent::getDefaultStateCasts(); if ($enumStateCast = $this->getEnumDefaultStateCast()) { $casts[] = $enumStateCast; } return $casts; } public function getEnumDefaultStateCast(): ?StateCast { $enum = $this->getEnum(); if (blank($enum)) { return null; } return app( EnumStateCast::class, ['enum' => $enum], ); } /** * @param array | Schema | Component | Action | ActionGroup | string | Htmlable | Closure | null $components */ public function aboveLabel(array | Schema | Component | Action | ActionGroup | string | Htmlable | Closure | null $components): static { $this->childComponents($components, static::ABOVE_LABEL_SCHEMA_KEY); return $this; } /** * @param array | Schema | Component | Action | ActionGroup | string | Htmlable | Closure | null $components */ public function belowLabel(array | Schema | Component | Action | ActionGroup | string | Htmlable | Closure | null $components): static { $this->childComponents($components, static::BELOW_LABEL_SCHEMA_KEY); return $this; } /** * @param array | Schema | Component | Action | ActionGroup | string | Htmlable | Closure | null $components */ public function beforeLabel(array | Schema | Component | Action | ActionGroup | string | Htmlable | Closure | null $components): static { $this->childComponents($components, static::BEFORE_LABEL_SCHEMA_KEY); return $this; } /** * @param array | Schema | Component | Action | ActionGroup | string | Htmlable | Closure | null $components */ public function afterLabel(array | Schema | Component | Action | ActionGroup | string | Htmlable | Closure | null $components): static { $this->childComponents($components, static::AFTER_LABEL_SCHEMA_KEY); return $this; } /** * @param array | Schema | Component | Action | ActionGroup | string | Htmlable | Closure | null $components */ public function aboveContent(array | Schema | Component | Action | ActionGroup | string | Htmlable | Closure | null $components): static { $this->childComponents($components, static::ABOVE_CONTENT_SCHEMA_KEY); return $this; } /** * @param array | Schema | Component | Action | ActionGroup | string | Htmlable | Closure | null $components */ public function belowContent(array | Schema | Component | Action | ActionGroup | string | Htmlable | Closure | null $components): static { $this->childComponents($components, static::BELOW_CONTENT_SCHEMA_KEY); return $this; } /** * @param array | Schema | Component | Action | ActionGroup | string | Htmlable | Closure | null $components */ public function beforeContent(array | Schema | Component | Action | ActionGroup | string | Htmlable | Closure | null $components): static { $this->childComponents($components, static::BEFORE_CONTENT_SCHEMA_KEY); return $this; } /** * @param array | Schema | Component | Action | ActionGroup | string | Htmlable | Closure | null $components */ public function afterContent(array | Schema | Component | Action | ActionGroup | string | Htmlable | Closure | null $components): static { $this->childComponents($components, static::AFTER_CONTENT_SCHEMA_KEY); return $this; } /** * @param array | Schema | Component | Action | ActionGroup | string | Htmlable | Closure | null $components */ public function aboveErrorMessage(array | Schema | Component | Action | ActionGroup | string | Htmlable | Closure | null $components): static { $this->childComponents($components, static::ABOVE_ERROR_MESSAGE_SCHEMA_KEY); return $this; } /** * @param array | Schema | Component | Action | ActionGroup | string | Htmlable | Closure | null $components */ public function belowErrorMessage(array | Schema | Component | Action | ActionGroup | string | Htmlable | Closure | null $components): static { $this->childComponents($components, static::BELOW_ERROR_MESSAGE_SCHEMA_KEY); return $this; } protected function makeChildSchema(string $key): Schema { $schema = parent::makeChildSchema($key); if (in_array($key, [static::AFTER_LABEL_SCHEMA_KEY, static::AFTER_CONTENT_SCHEMA_KEY])) { $schema->alignEnd(); } return $schema; } protected function configureChildSchema(Schema $schema, string $key): Schema { $schema = parent::configureChildSchema($schema, $key); if (in_array($key, [ static::ABOVE_LABEL_SCHEMA_KEY, static::BELOW_LABEL_SCHEMA_KEY, static::BEFORE_LABEL_SCHEMA_KEY, static::AFTER_LABEL_SCHEMA_KEY, static::ABOVE_CONTENT_SCHEMA_KEY, static::BELOW_CONTENT_SCHEMA_KEY, static::BEFORE_CONTENT_SCHEMA_KEY, static::AFTER_CONTENT_SCHEMA_KEY, static::ABOVE_ERROR_MESSAGE_SCHEMA_KEY, static::BELOW_ERROR_MESSAGE_SCHEMA_KEY, ])) { $schema ->inline() ->embeddedInParentComponent() ->modifyActionsUsing(fn (Action $action) => $action ->defaultSize(Size::Small) ->defaultView(Action::LINK_VIEW)) ->modifyActionGroupsUsing(fn (ActionGroup $actionGroup) => $actionGroup->defaultSize(Size::Small)); } return $schema; } public function hasErrorForPath(?string $statePath): bool { if (blank($statePath)) { return false; } $errors = view()->shared('errors'); if (! $errors instanceof ViewErrorBag) { return false; } return $errors->has($statePath); } /** * @internal This method is not part of the public API and should not be used. Its parameters may change at any time without notice. * * @param array $extraWrapperAttributes */ public function wrapEmbeddedHtml( string $html, array $extraWrapperAttributes = [], ?VerticalAlignment $inlineLabelVerticalAlignment = null, string | Htmlable | null $labelPrefix = null, string | Htmlable | null $labelSuffix = null, string $labelTag = 'label', ): string { $statePath = $this->getStatePath(); $hasNestedRecursiveValidationRules = $this instanceof Contracts\HasNestedRecursiveValidationRules; /** @var MessageBag $errors */ $errors = view()->shared('errors') instanceof ViewErrorBag ? view()->shared('errors')->getBag('default') : new MessageBag; $hasError = filled($statePath) && ($errors->has($statePath) || ($hasNestedRecursiveValidationRules && $errors->has("{$statePath}.*"))); $errorMessage = null; $errorMessages = null; if ($hasError) { if ($this->shouldShowAllValidationMessages()) { $errorMessages = $errors->has($statePath) ? $errors->get($statePath) : ($hasNestedRecursiveValidationRules ? $errors->get("{$statePath}.*") : []); if (count($errorMessages) === 1) { $errorMessage = Arr::first($errorMessages); $errorMessages = []; } } else { $errorMessage = $errors->has($statePath) ? $errors->first($statePath) : ($hasNestedRecursiveValidationRules ? $errors->first("{$statePath}.*") : null); } } $fieldWrapperView = $this->getFieldWrapperView(); $isDefaultFieldWrapperView = $fieldWrapperView === 'filament-forms::field-wrapper'; if ( (! $isDefaultFieldWrapperView) || ViewComponent::hasPublishedEmbeddedViewOverride('filament-forms::components.field-wrapper') ) { $absoluteView = $isDefaultFieldWrapperView ? 'filament-forms::components.field-wrapper' : (string) (str($fieldWrapperView)->contains('::') ? str($fieldWrapperView)->replaceFirst('::', '::components.') : str("components.{$fieldWrapperView}")); if (view()->exists($absoluteView)) { return view($absoluteView, [ 'field' => $this, 'slot' => new ComponentSlot($html), 'labelPrefix' => $labelPrefix, 'labelSuffix' => $labelSuffix, 'inlineLabelVerticalAlignment' => $inlineLabelVerticalAlignment ?? VerticalAlignment::Start, 'labelTag' => $labelTag, 'attributes' => (new FilamentComponentAttributeBag)->merge($extraWrapperAttributes, escape: false), 'hasErrors' => $hasError, 'errorMessage' => $errorMessage, 'errorMessages' => $errorMessages, ])->toHtml(); } return $this->renderWrapperBladeComponent( $fieldWrapperView, new ComponentSlot($html), (new FilamentComponentAttributeBag([ 'field' => $this, 'label-prefix' => $labelPrefix, 'label-suffix' => $labelSuffix, 'inline-label-vertical-alignment' => $inlineLabelVerticalAlignment ?? VerticalAlignment::Start, 'label-tag' => $labelTag, 'has-errors' => $hasError, 'error-message' => $errorMessage, 'error-messages' => $errorMessages, ]))->merge($extraWrapperAttributes, escape: false), ); } $hasInlineLabel = $this->hasInlineLabel(); $id = $this->getId(); $isDisabled = $this->isDisabled(); $label = $this->getLabel(); $labelSrOnly = $this->isLabelHidden(); $required = $this->isMarkedAsRequired(); $aboveLabelSchema = $this->getChildSchema(static::ABOVE_LABEL_SCHEMA_KEY)?->toHtmlString(); $belowLabelSchema = $this->getChildSchema(static::BELOW_LABEL_SCHEMA_KEY)?->toHtmlString(); $beforeLabelSchema = $this->getChildSchema(static::BEFORE_LABEL_SCHEMA_KEY)?->toHtmlString(); $afterLabelSchema = $this->getChildSchema(static::AFTER_LABEL_SCHEMA_KEY)?->toHtmlString(); $aboveContentSchema = $this->getChildSchema(static::ABOVE_CONTENT_SCHEMA_KEY)?->toHtmlString(); $belowContentSchema = $this->getChildSchema(static::BELOW_CONTENT_SCHEMA_KEY)?->toHtmlString(); $beforeContentSchema = $this->getChildSchema(static::BEFORE_CONTENT_SCHEMA_KEY)?->toHtmlString(); $afterContentSchema = $this->getChildSchema(static::AFTER_CONTENT_SCHEMA_KEY)?->toHtmlString(); $aboveErrorMessageSchema = $this->getChildSchema(static::ABOVE_ERROR_MESSAGE_SCHEMA_KEY)?->toHtmlString(); $belowErrorMessageSchema = $this->getChildSchema(static::BELOW_ERROR_MESSAGE_SCHEMA_KEY)?->toHtmlString(); $areHtmlErrorMessagesAllowed = $this->areHtmlValidationMessagesAllowed(); $wrapperAttributes = (new FilamentComponentAttributeBag) ->merge($extraWrapperAttributes, escape: false) ->merge($this->getExtraFieldWrapperAttributes(), escape: false) ->class([ 'fi-fo-field', 'fi-fo-field-has-inline-label' => $hasInlineLabel, ]); $inlineLabelVerticalAlignment ??= VerticalAlignment::Start; ob_start(); ?>
toHtml() ?>> < for="" id="-label" class="fi-fo-field-label fi-sr-only" > >
class([ 'fi-fo-field-label-col', "fi-vertical-align-{$inlineLabelVerticalAlignment->value}" => $hasInlineLabel, ])->toHtml() ?> > toHtml() ?>
class([ 'fi-fo-field-label-ctn', ($label instanceof ComponentSlot) ? $label->attributes->get('class') : null, ])->toHtml() ?> > toHtml() ?> < for="" id="-label" class="fi-fo-field-label" > * > toHtml() ?>
toHtml() ?>
toHtml() ?>
toHtml() ?>
toHtml() ?>
toHtml() ?> toHtml() ?>

toHtml() ?>
getPrefixLabel() : null; $prefixActions = $hasAffixes ? array_filter( $this->getPrefixActions(), static fn (Action $prefixAction): bool => $prefixAction->isVisible(), ) : []; $prefixIcon = $hasAffixes ? $this->getPrefixIcon() : null; $prefixIconColor = ($hasAffixes ? $this->getPrefixIconColor() : null) ?? 'gray'; $suffix = $hasAffixes ? $this->getSuffixLabel() : null; $suffixActions = $hasAffixes ? array_filter( $this->getSuffixActions(), static fn (Action $suffixAction): bool => $suffixAction->isVisible(), ) : []; $suffixIcon = $hasAffixes ? $this->getSuffixIcon() : null; $suffixIconColor = ($hasAffixes ? $this->getSuffixIconColor() : null) ?? 'gray'; $hasPrefix = count($prefixActions) || $prefixIcon || filled($prefix); $hasSuffix = count($suffixActions) || $suffixIcon || filled($suffix); $hasInlinePrefix = $hasAffixes && $hasPrefix && $this->isPrefixInline(); $hasInlineSuffix = $hasAffixes && $hasSuffix && $this->isSuffixInline(); $isDisabled = $this->isDisabled(); $isValid = ! $this->hasErrorForPath($this->getStatePath()); $hasAlpineDisabledClasses = filled($alpineDisabled); $hasAlpineValidClasses = filled($alpineValid); $hasAlpineClasses = $hasAlpineDisabledClasses || $hasAlpineValidClasses; $wireTarget = $attributes->whereStartsWith(['wire:target'])->first(); $hasLoadingIndicator = filled($wireTarget); $loadingIndicatorTarget = $hasLoadingIndicator ? html_entity_decode((string) $wireTarget, ENT_QUOTES) : null; $loadingDelay = config('filament.livewire_loading_delay', 'default'); $hasFocusInputListener = $attributes->has('x-on:focus-input.stop'); $canClickPrefixAffix = $hasFocusInputListener && ($prefixIcon || filled($prefix)); $canClickSuffixAffix = $hasFocusInputListener && ($suffixIcon || filled($suffix)); $wrapperAttributes = $attributes ->except(['wire:target', 'tabindex']) ->class([ 'fi-input-wrp', 'fi-disabled' => (! $hasAlpineClasses) && $isDisabled, 'fi-invalid' => (! $hasAlpineClasses) && (! $isValid), ]); if ($hasAlpineClasses) { $alpineClassParts = []; if ($hasAlpineDisabledClasses) { $alpineClassParts[] = "'fi-disabled': {$alpineDisabled}"; } if ($hasAlpineValidClasses) { $alpineClassParts[] = "'fi-invalid': ! ({$alpineValid})"; } $wrapperAttributes = $wrapperAttributes->merge([ 'x-bind:class' => '{ ' . implode(', ', $alpineClassParts) . ' }', ], escape: false); } ob_start(); ?>
toHtml() ?>> class([ 'fi-input-wrp-prefix', 'fi-input-wrp-prefix-has-content' => $hasPrefix, 'fi-inline' => $hasInlinePrefix, 'fi-input-wrp-prefix-has-label' => filled($prefix), ]); if (! $hasPrefix) { $prefixDivAttributes = $prefixDivAttributes->merge([ 'wire:loading.delay.' . $loadingDelay . '.flex' => true, 'wire:target' => $loadingIndicatorTarget, // Forces the loading indicator to hide once the request completes. 'wire:key' => Str::random(), ], escape: false); } if ($canClickPrefixAffix) { $prefixDivAttributes = $prefixDivAttributes->merge([ 'x-on:click' => '$dispatch(\'focus-input\')', ], escape: false); } ?>
toHtml() ?>>
x-on:click.stop > toHtml() ?>
merge([ 'wire:loading.remove.delay.' . $loadingDelay => $hasLoadingIndicator, 'wire:target' => $hasLoadingIndicator ? $loadingIndicatorTarget : false, ], escape: false) ->color(IconComponent::class, $prefixIconColor), )?->toHtml() ?> $hasPrefix, 'wire:target' => $hasPrefix ? $loadingIndicatorTarget : null, ]))->color(IconComponent::class, 'gray'))->toHtml() ?>
class([ 'fi-input-wrp-content-ctn', 'fi-input-wrp-content-ctn-ps' => $hasLoadingIndicator && (! $hasPrefix) && $hasInlinePrefix, ]); if ($hasLoadingIndicator && (! $hasPrefix)) { $contentCtnAttributes = $contentCtnAttributes->merge([ 'wire:target' => $loadingIndicatorTarget, 'wire:loading.delay.' . $loadingDelay . '.class.remove' => $hasInlinePrefix ? 'ps-3' : false, ], escape: false); } ?>
toHtml() ?>>
class([ 'fi-input-wrp-suffix', 'fi-inline' => $hasInlineSuffix, 'fi-input-wrp-suffix-has-label' => filled($suffix), ]); if ($canClickSuffixAffix) { $suffixDivAttributes = $suffixDivAttributes->merge([ 'x-on:click' => '$dispatch(\'focus-input\')', ], escape: false); } ?>
toHtml() ?>> merge([ 'wire:loading.remove.delay.' . $loadingDelay => $hasLoadingIndicator, 'wire:target' => $hasLoadingIndicator ? $loadingIndicatorTarget : false, ], escape: false) ->color(IconComponent::class, $suffixIconColor), )?->toHtml() ?>
x-on:click.stop > toHtml() ?>
getBaseLabel())) { return $label; } return $this->getDefaultLabel(); } public function getDefaultLabel(): string { $label = (string) str($this->getName()) ->afterLast('.') ->kebab() ->replace(['-', '_'], ' ') ->ucfirst(); return $this->shouldTranslateLabel ? __($label) : $label; } }