| null $badgeColor, * @param string | array | null $color, * @param array $keyBindings */ public function generateButtonHtml( ComponentAttributeBag $attributes, string | Htmlable | null $badge = null, string | array | null $badgeColor = 'primary', Size | string | null $badgeSize = null, string | array | null $color = null, ?string $form = null, ?string $formId = null, bool $hasLoadingIndicator = true, ?bool $hasSpaMode = null, ?string $href = null, string | BackedEnum | Htmlable | null $icon = null, ?string $iconAlias = null, ?IconPosition $iconPosition = IconPosition::Before, IconSize | string | null $iconSize = null, bool $isDisabled = false, bool $isLabelSrOnly = false, bool $isOutlined = false, ?array $keyBindings = null, string | Htmlable | null $label = null, ?string $labeledFromBreakpoint = null, Size | string | null $size = null, string $tag = 'button', ?string $target = null, string | Htmlable | null $tooltip = null, ?string $type = 'button', ): string { $badgeColor ??= 'primary'; $color ??= 'primary'; if (! $iconPosition instanceof IconPosition) { $iconPosition = filled($iconPosition) ? (IconPosition::tryFrom($iconPosition) ?? $iconPosition) : null; } if (! $size instanceof Size) { $size = filled($size) ? (Size::tryFrom($size) ?? $size) : Size::Medium; } if (! $badgeSize instanceof Size) { $badgeSize = filled($badgeSize) ? (Size::tryFrom($badgeSize) ?? $badgeSize) : Size::ExtraSmall; } if (filled($iconSize) && (! $iconSize instanceof IconSize)) { $iconSize = IconSize::tryFrom($iconSize) ?? $iconSize; } $iconSize ??= match ($size) { Size::ExtraSmall, Size::Small => IconSize::Small, default => null, }; $wireTarget = $hasLoadingIndicator ? $attributes->whereStartsWith(['wire:target', 'wire:click'])->filter(fn ($value): bool => filled($value))->first() : null; $hasFormProcessingLoadingIndicator = $type === 'submit' && filled($form); $hasLoadingIndicator = filled($wireTarget) || $hasFormProcessingLoadingIndicator; if ($hasLoadingIndicator) { $loadingIndicatorTarget = html_entity_decode($wireTarget ?: $form, ENT_QUOTES); } $hasTooltip = filled($tooltip); $formAttributes = $attributes->only(['action', 'method', 'wire:submit']); $attributes = $attributes ->when( $tag === 'form', fn (ComponentAttributeBag $attributes) => $attributes->except(['action', 'class', 'method', 'wire:submit']), ) ->merge([ 'aria-disabled' => $isDisabled ? 'true' : null, // Security: These attributes are rendered without escaping, so the `aria-label` must be escaped here, otherwise an `Htmlable` label could break out of the attribute. `doubleEncode: false` preserves entities that Blade has already escaped in a string label. 'aria-label' => $isLabelSrOnly ? e(trim(strip_tags($label instanceof Htmlable ? $label->toHtml() : ($label ?? ''))), doubleEncode: false) : null, 'disabled' => $isDisabled && blank($tooltip), 'form' => $formId, 'tabindex' => (($tag === 'a') && $isDisabled && $hasTooltip) ? '0' : null, 'type' => match ($tag) { 'button' => $type, 'form' => 'submit', default => null, }, 'wire:loading.attr' => $tag === 'button' ? 'disabled' : null, 'wire:target' => ($hasLoadingIndicator && $loadingIndicatorTarget) ? $loadingIndicatorTarget : null, 'x-bind:disabled' => $hasFormProcessingLoadingIndicator ? 'isProcessing' : null, 'x-bind:aria-label' => ($isLabelSrOnly && $hasFormProcessingLoadingIndicator) ? ('isProcessing ? processingMessage : ' . Js::from(trim(strip_tags($label instanceof Htmlable ? $label->toHtml() : ($label ?? ''))))) : null, ], escape: false) ->when( $isDisabled && $hasTooltip, fn (ComponentAttributeBag $attributes) => $attributes->filter( fn (mixed $value, string $key): bool => ! str($key)->startsWith(['href', 'x-on:', 'wire:click']), ), ); $buttonComponent = ButtonComponent::make($isOutlined); $buttonAttributes = $attributes ->class([ 'fi-btn', 'fi-disabled' => $isDisabled, 'fi-outlined' => $isOutlined, ($size instanceof Size) ? "fi-size-{$size->value}" : $size, is_string($labeledFromBreakpoint) ? "fi-labeled-from-{$labeledFromBreakpoint}" : null, ]) ->color($buttonComponent, $color); $iconButtonAttributes = $attributes; if ($labeledFromBreakpoint && filled($wireKey = $attributes->get('wire:key'))) { $iconButtonAttributes = $attributes ->except(['wire:key']) ->merge(['wire:key' => "{$wireKey}.icon-button"], escape: false); } $loadingDelay = ($icon || $iconAlias || $hasLoadingIndicator) ? config('filament.livewire_loading_delay', 'default') : null; $iconHtml = ($icon || $iconAlias) ? generate_icon_html($icon, $iconAlias, (new FilamentComponentAttributeBag([ 'wire:loading.remove.delay.' . $loadingDelay => $hasLoadingIndicator, 'wire:target' => $hasLoadingIndicator ? $loadingIndicatorTarget : false, ])), size: $iconSize)?->toHtml() ?? '' : ''; $loadingIndicatorHtml = $hasLoadingIndicator ? generate_loading_indicator_html((new FilamentComponentAttributeBag([ 'wire:loading.delay.' . $loadingDelay => '', 'wire:target' => $loadingIndicatorTarget, ])), size: $iconSize)->toHtml() : ''; $formProcessingLoadingIndicatorHtml = $hasFormProcessingLoadingIndicator ? generate_loading_indicator_html((new FilamentComponentAttributeBag([ 'x-cloak' => 'x-cloak', 'x-show' => 'isProcessing', ])), size: $iconSize)->toHtml() : ''; ob_start(); ?> generateIconButtonHtml( attributes: $iconButtonAttributes, badge: $badge, badgeColor: $badgeColor, badgeSize: $badgeSize, color: $color, form: $form, formId: $formId, hasLoadingIndicator: $hasLoadingIndicator, hasSpaMode: $hasSpaMode, href: $href, icon: $icon, iconAlias: $iconAlias, iconSize: $iconSize, isDisabled: $isDisabled, keyBindings: $keyBindings, label: $label, size: $size, tag: $tag, target: $target, tooltip: $tooltip, type: $type, ) ?> toHtml() . '>' . csrf_field()) : '' ?> < toHtml() ?> x-bind:id="$id('key-bindings')" x-mousetrap.global.map(fn (string $keyBinding): string => str_replace('+', '-', $keyBinding))->implode('.') ?>="document.getElementById($el.id)?.click()" x-tooltip="{ content: , theme: $store.theme, allowHTML: , }" x-data="filamentFormButton" x-bind:class="{ 'fi-processing': isProcessing }" toHtml() ?> >
color(BadgeComponent::class, $badgeColor)->class([ 'fi-badge', ($badgeSize instanceof Size) ? "fi-size-{$badgeSize->value}" : $badgeSize, ])->toHtml() ?>>
> ' : '' ?>