| Closure $steps */ final public function __construct(array | Closure $steps = []) { $this->steps($steps); } /** * @param array | Closure $steps */ public static function make(array | Closure $steps = []): static { $static = app(static::class, ['steps' => $steps]); $static->configure(); return $static; } protected function setUp(): void { parent::setUp(); $this->key(function (Wizard $component): string { $statePath = $component->getStatePath(); $label = $component->getLabel(); if (blank($label)) { return filled($statePath) ? "{$statePath}::wizard" : 'wizard'; } return Str::slug(Str::transliterate($label, strict: true)) . '::' . (filled($statePath) ? "{$statePath}::wizard" : 'wizard'); }, isInheritable: false); $this->registerActions([ fn (Wizard $component): Action => $component->getNextAction(), fn (Wizard $component): Action => $component->getPreviousAction(), ]); } #[ExposedLivewireMethod] public function nextStep(int $currentStepIndex): void { if (! $this->isSkippable()) { $steps = array_values( $this ->getChildSchema() ->getComponents() ); /** @var Step $currentStep */ $currentStep = $steps[$currentStepIndex]; /** @var ?Step $nextStep */ $nextStep = $steps[$currentStepIndex + 1] ?? null; $this->currentStepIndex($currentStepIndex + 1); try { $currentStep->callBeforeValidation(); $currentStep->getChildSchema()->validate(); $currentStep->callAfterValidation(); $nextStep?->fillStateWithNull(); } catch (Halt $exception) { return; } } /** @var HasSchemas&LivewireComponent $livewire */ $livewire = $this->getLivewire(); $livewire->dispatch('next-wizard-step', key: $this->getKey()); } #[ExposedLivewireMethod] public function previousStep(int $currentStepIndex): void { if ($currentStepIndex < 1) { $currentStepIndex = 1; } $this->currentStepIndex($currentStepIndex - 1); } public function goToStep(string $step): void { $steps = array_values( $this->getChildSchema()->getComponents() ); foreach ($steps as $index => $wizardStep) { if ($wizardStep->getKey() !== $step) { continue; } if ((! $this->isSkippable()) && ($index > $this->getCurrentStepIndex())) { return; } $this->currentStepIndex($index); /** @var HasSchemas&LivewireComponent $livewire */ $livewire = $this->getLivewire(); $livewire->dispatch( 'go-to-wizard-step', key: $this->getKey(), step: $step, ); return; } } public function getNextAction(): Action { $action = Action::make($this->getNextActionName()) ->label(__('filament-schemas::components.wizard.actions.next_step.label')) ->iconPosition(IconPosition::After) ->livewireClickHandlerEnabled(false) ->livewireTarget('callSchemaComponentMethod') ->button(); if ($this->modifyNextActionUsing) { $action = $this->evaluate($this->modifyNextActionUsing, [ 'action' => $action, ]) ?? $action; } return $action; } public function nextAction(?Closure $callback): static { $this->modifyNextActionUsing = $callback; return $this; } public function getNextActionName(): string { return 'next'; } public function getPreviousAction(): Action { $action = Action::make($this->getPreviousActionName()) ->label(__('filament-schemas::components.wizard.actions.previous_step.label')) ->color('gray') ->livewireClickHandlerEnabled(false) ->button(); if ($this->modifyPreviousActionUsing) { $action = $this->evaluate($this->modifyPreviousActionUsing, [ 'action' => $action, ]) ?? $action; } return $action; } public function previousAction(?Closure $callback): static { $this->modifyPreviousActionUsing = $callback; return $this; } public function getPreviousActionName(): string { return 'previous'; } /** * @param array | Closure $steps */ public function steps(array | Closure $steps): static { $this->components($steps); return $this; } public function startOnStep(int | Closure $startStep): static { $this->startStep = $startStep; return $this; } public function cancelAction(string | Htmlable | null $action): static { $this->cancelAction = $action; return $this; } public function submitAction(string | Htmlable | null $action): static { $this->submitAction = $action; return $this; } public function skippable(bool | Closure $condition = true): static { $this->isSkippable = $condition; return $this; } public function persistStepInQueryString(string | Closure | null $key = 'step'): static { $this->stepQueryStringKey = $key; return $this; } public function getCancelAction(): string | Htmlable | null { return $this->cancelAction; } public function getSubmitAction(): string | Htmlable | null { return $this->submitAction; } public function getStartStep(): int { if ($this->isStepPersistedInQueryString()) { $queryStringStep = request()->query($this->getStepQueryStringKey()); foreach ($this->getChildSchema()->getComponents() as $index => $step) { if ($step->getId() !== $queryStringStep) { continue; } return $index + 1; } } return $this->evaluate($this->startStep); } public function getStepQueryStringKey(): ?string { return $this->evaluate($this->stepQueryStringKey); } public function isSkippable(): bool { return (bool) $this->evaluate($this->isSkippable); } public function isStepPersistedInQueryString(): bool { return filled($this->getStepQueryStringKey()); } public function getCurrentStepIndex(): int { return $this->currentStepIndex ??= ($this->getStartStep() - 1); } protected function currentStepIndex(int $index): static { $this->currentStepIndex = $index; return $this; } public function alpineSubmitHandler(string | Closure | null $handler): static { $this->alpineSubmitHandler = $handler; return $this; } public function getAlpineSubmitHandler(): ?string { return $this->evaluate($this->alpineSubmitHandler); } public function hiddenHeader(bool | Closure $condition = true): static { $this->isHeaderHidden = $condition; return $this; } public function isHeaderHidden(): bool { return (bool) $this->evaluate($this->isHeaderHidden); } public function toEmbeddedHtml(): string { $isContained = $this->isContained(); $key = $this->getKey(); $previousAction = $this->getAction('previous'); $nextAction = $this->getAction('next'); $steps = array_filter( $this->getChildSchema()->getComponents(), static fn ($component): bool => $component instanceof Step, ); $isHeaderHidden = $this->isHeaderHidden(); $outerAttributes = (new FilamentComponentAttributeBag) ->merge([ 'id' => $this->getId(), ], escape: false) ->merge($this->getExtraAttributes(), escape: false) ->merge($this->getExtraAlpineAttributes(), escape: false) ->class([ 'fi-sc-wizard', 'fi-contained' => $isContained, 'fi-sc-wizard-header-hidden' => $isHeaderHidden, ]); ob_start(); ?>

toHtml() ?> >

toHtml() ?>

isDisabled()) { ?> x-on:click="goToPreviousStep" x-show="! isFirstStep()" > toHtml() ?>

getCancelAction()) ?>

isDisabled()) { ?> x-on:click="requestNextStep()" x-bind:class="{ 'fi-hidden': isLastStep() }" wire:loading.class="fi-disabled" > toHtml() ?>

getSubmitAction()) ?>