resetValidation компонента Livewire

Метод resetValidation класса Component в Livewire предназначен для очистки всех ошибок валидации, связанных с текущим компонентом. Он полностью сбрасывает содержимое объекта ошибок (error bag), что позволяет убрать все сообщения об ошибках, отображаемые в шаблоне после валидации. Метод не принимает аргументов и не возвращает значения.

Синтаксис

<?php
	namespace AppLivewire;
	
	use LivewireComponent;
	
	class MyComponent extends Component
	{
		public function someMethod()
		{
			$this->resetValidation();
		}
	}
?>

Пример использования для очистки ошибок

Давайте создадим компонент с формой, содержащей поле ввода и кнопку отправки. При клике на кнопку будет выполняться валидация, а по нажатию на кнопку сброса - очищаться все сообщения об ошибках:

<?php
	namespace AppLivewire;
	
	use LivewireComponent;
	
	class UserForm extends Component
	{
		public $name = '';
		
		public function submit()
		{
			$this->validate([
				'name' => 'required|min:3',
			]);
		}
		
		public function clearErrors()
		{
			$this->resetValidation();
		}
		
		public function render()
		{
			return view('livewire.user-form');
		}
	}
?>

<form wire:submit.prevent="submit">
	<input type="text" wire:model="name">
	@error('name') <span>{{ $message }}</span> @enderror
	
	<button type="submit">Submit</button>
	<button type="button" wire:click="clearErrors">Clear Errors</button>
</form>

В этом примере метод resetValidation вызывается по клику на кнопку "Clear Errors", что приводит к немедленному скрытию всех сообщений об ошибках в интерфейсе пользователя.

Пример сброса после успешной отправки

Часто возникает необходимость очистить ошибки валидации после успешной отправки формы, чтобы подготовить компонент к следующему вводу данных. Рассмотрим такой пример:

<?php
	namespace AppLivewire;
	
	use LivewireComponent;
	
	class ContactForm extends Component
	{
		public $email = '';
		public $message = '';
		public $success = false;
		
		public function send()
		{
			$this->validate([
				'email' => 'required|email',
				'message' => 'required|min:10',
			]);
			
			// Logic for sending message
			// ...
			
			$this->success = true;
			$this->resetValidation();
		}
		
		public function render()
		{
			return view('livewire.contact-form');
		}
	}
?>

<form wire:submit.prevent="send">
	<input type="email" wire:model="email">
	@error('email') <span>{{ $message }}</span> @enderror
	
	<textarea wire:model="message"></textarea>
	@error('message') <span>{{ $message }}</span> @enderror
	
	<button type="submit">Send</button>
	
	@if ($success)
		<div>Message sent successfully!</div>
	@endif
</form>

После успешной валидации и отправки данных метод resetValidation очищает все сообщения об ошибках, а пользователь видит только сообщение об успехе.

Пример сброса конкретных ошибок

Хотя метод resetValidation очищает все ошибки компонента, при необходимости можно сбросить ошибки для конкретного поля, используя метод resetErrorBag или напрямую работая с объектом ошибок. Однако, если требуется сбросить только ошибки для определенного поля, можно использовать комбинацию с методами валидации:

<?php
	namespace AppLivewire;
	
	use LivewireComponent;
	
	class ProfileForm extends Component
	{
		public $username = '';
		public $bio = '';
		
		public function updateUsername()
		{
			$this->validateOnly('username', [
				'username' => 'required|min:3',
			]);
		}
		
		public function clearAllErrors()
		{
			$this->resetValidation();
		}
		
		public function render()
		{
			return view('livewire.profile-form');
		}
	}
?>

<div>
	<input type="text" wire:model="username" wire:blur="updateUsername">
	@error('username') <span>{{ $message }}</span> @enderror
	
	<textarea wire:model="bio"></textarea>
	@error('bio') <span>{{ $message }}</span> @enderror
	
	<button wire:click="clearAllErrors">Clear All Errors</button>
</div>

В этом примере метод resetValidation вызывается по клику на кнопку "Clear All Errors" и сбрасывает все сообщения об ошибках, в том числе для поля bio, даже если они были добавлены через валидацию в других методах.

Смотрите также

метод validate,
который выполняет валидацию свойств компонента
метод validateOnly,
который выполняет валидацию только одного поля
метод resetErrorBag,
который сбрасывает все ошибки валидации компонента
метод addError,
который добавляет пользовательскую ошибку валидации