From 2ea6132d60edcc1e750fc993d24c9de645c7e4f4 Mon Sep 17 00:00:00 2001
From: Alexander Nikushkin <nikushkin@mail.ru>
Date: Wed, 8 Nov 2023 18:38:35 +0500
Subject: [PATCH] docs(fields): updateOnPreview() method for Text, Checkbox and
 Select fields

---
 .../views/pages/ru/fields/checkbox.blade.php  |  9 +++--
 .../views/pages/ru/fields/select.blade.php    |  6 ++++
 .../fields/shared/update_on_preview.blade.php | 35 +++++++++++++++++++
 .../views/pages/ru/fields/text.blade.php      |  6 ++++
 4 files changed, 53 insertions(+), 3 deletions(-)
 create mode 100644 resources/views/pages/ru/fields/shared/update_on_preview.blade.php

diff --git a/resources/views/pages/ru/fields/checkbox.blade.php b/resources/views/pages/ru/fields/checkbox.blade.php
index 79f69c47..19632cc5 100644
--- a/resources/views/pages/ru/fields/checkbox.blade.php
+++ b/resources/views/pages/ru/fields/checkbox.blade.php
@@ -2,11 +2,15 @@
     title="Checkbox"
     :sectionMenu="[
         'Разделы' => [
+            ['url' => '#make', 'label' => 'Make'],
             ['url' => '#on-off', 'label' => 'Значения on/off'],
+            ['url' => '#update-on-preview', 'label' => 'Редактирование в preview'],
         ]
     ]"
 >
 
+<x-sub-title id="make">Make</x-sub-title>
+
 <x-p>
     Поле <em>Checkbox</em> включает в себя все базовые методы.
 </x-p>
@@ -58,7 +62,6 @@ public function fields(): array
 //...
 </x-code>
 
-</x-page>
-
-
+@include('pages.ru.fields.shared.update_on_preview', ['field' => 'Checkbox'])
 
+</x-page>
diff --git a/resources/views/pages/ru/fields/select.blade.php b/resources/views/pages/ru/fields/select.blade.php
index 8455f3b8..e362171a 100644
--- a/resources/views/pages/ru/fields/select.blade.php
+++ b/resources/views/pages/ru/fields/select.blade.php
@@ -2,16 +2,20 @@
     title="Select"
     :sectionMenu="[
         'Разделы' => [
+            ['url' => '#make', 'label' => 'Make'],
             ['url' => '#default', 'label' => 'Значение по умолчанию'],
             ['url' => '#nullable', 'label' => 'Nullable'],
             ['url' => '#groups', 'label' => 'Группы'],
             ['url' => '#multiple', 'label' => 'Несколько значений'],
             ['url' => '#searchable', 'label' => 'Поиск'],
             ['url' => '#async', 'label' => 'Асинхронный поиск'],
+            ['url' => '#update-on-preview', 'label' => 'Редактирование в preview'],
         ]
     ]"
 >
 
+<x-sub-title id="make">Make</x-sub-title>
+
 <x-p>
     Поле <em>Select</em> включает в себя все базовые методы.
 </x-p>
@@ -256,4 +260,6 @@ public function fields(): array
 //...
 </x-code>
 
+@include('pages.ru.fields.shared.update_on_preview', ['field' => 'Select'])
+
 </x-page>
diff --git a/resources/views/pages/ru/fields/shared/update_on_preview.blade.php b/resources/views/pages/ru/fields/shared/update_on_preview.blade.php
new file mode 100644
index 00000000..2ed7a9a3
--- /dev/null
+++ b/resources/views/pages/ru/fields/shared/update_on_preview.blade.php
@@ -0,0 +1,35 @@
+<x-sub-title id="update-on-preview">Редактирование в preview</x-sub-title>
+
+<x-p>
+    Метод <code>updateOnPreview()</code> позволяет редактировать поле <em>{{ $field }}</em> в режиме <em>preview</em>.
+</x-p>
+
+<x-code language="php">
+updateOnPreview(?Closure $url = null, ?ResourceContract $resource = null, mixed $condition = null)
+</x-code>
+
+<x-p>
+    <code>$url</code> - url для обработки асинхронного запроса,<br>
+    <code>$resource</code> - ресурс модели на которую ссылается отношение,<br>
+    <code>$condition</code> -условия выполнения метода.
+</x-p>
+
+<x-moonshine::alert type="default" icon="heroicons.information-circle">
+    Параметры не являются обязательными и их необходимо передавать, если поле работает вне ресурса.
+</x-moonshine::alert>
+
+<x-code language="php">
+use MoonShine\Fields\{{ $field }};
+
+//...
+
+public function fields(): array
+{
+    return [
+        {{ $field }}::make({!! $field === 'Checkbox' ? 'Public' : 'Country' !!})
+            ->updateOnPreview() // [tl! focus]
+    ];
+}
+
+//...
+</x-code>
diff --git a/resources/views/pages/ru/fields/text.blade.php b/resources/views/pages/ru/fields/text.blade.php
index aba622fc..813424e9 100644
--- a/resources/views/pages/ru/fields/text.blade.php
+++ b/resources/views/pages/ru/fields/text.blade.php
@@ -2,14 +2,18 @@
     title="Текстовое поле"
     :sectionMenu="[
         'Разделы' => [
+            ['url' => '#make', 'label' => 'Make'],
             ['url' => '#default', 'label' => 'Значение по умолчанию'],
             ['url' => '#readonly', 'label' => 'Только для чтения'],
             ['url' => '#mask', 'label' => 'Маска'],
             ['url' => '#extensions', 'label' => 'Расширения'],
+            ['url' => '#update-on-preview', 'label' => 'Редактирование в preview'],
         ]
     ]"
 >
 
+<x-sub-title id="make">Make</x-sub-title>
+
 <x-p>
     Текстовое поле включает в себя все базовые методы.
 </x-p>
@@ -192,4 +196,6 @@ public function fields(): array
 //...
 </x-code>
 
+@include('pages.ru.fields.shared.update_on_preview', ['field' => 'Text'])
+
 </x-page>