Merge pull request #446 from DissNik/2.0

docs(fields): HiddenIds
moonshine-software · Apr 21, 2024 · 41ef666 · 41ef666
2 parents ba8a0d3 + 3fc2099
commit 41ef666
Show file tree

Hide file tree

Showing 3 changed files with 109 additions and 0 deletions.
diff --git a/config/menu.php b/config/menu.php
@@ -97,6 +97,7 @@
         ['slug' => 'fields-morph_to_many', 'label' => 'MorphToMany'],
 
         'Other:_divider_',
+        ['slug' => 'fields-hidden_ids', 'label' => 'HiddenIds'],
         ['slug' => 'fields-preview', 'label' => 'Preview'],
         ['slug' => 'fields-position', 'label' => 'Position'],
         ['slug' => 'fields-stack_fields', 'label' => 'StackFields'],

diff --git a/resources/views/pages/en/fields/hidden_ids.blade.php b/resources/views/pages/en/fields/hidden_ids.blade.php
@@ -0,0 +1,54 @@
+<x-page
+    title="HiddenIds"
+    :sectionMenu="[
+        'Разделы' => [
+            ['url' => '#make', 'label' => 'Make'],
+            ['url' => '#use', 'label' => 'Use'],
+        ]
+    ]"
+>
+
+<x-p>
+    The <em>HiddenIds</em> field is used to pass the primary key of the selected elements.
+</x-p>
+
+<x-sub-title id="make">Make</x-sub-title>
+
+<x-p>
+    The <code>make()</code> method takes the name of the component as a parameter.
+</x-p>
+
+<x-code language="php">
+HiddenIds::make('index-table')
+</x-code>
+
+<x-sub-title id="use">Use</x-sub-title>
+
+<x-code language="php">
+use MoonShine\Components\FlexibleRender;
+use MoonShine\ActionButtons\ActionButton;
+use MoonShine\Fields\HiddenIds; // [tl! focus]
+
+//...
+
+public function buttons(): array
+{
+    return [
+        ActionButton::make('Active', route('moonshine.posts.mass-active', $this->uriKey()))
+            ->inModal(fn () => 'Active', fn (): string => (string) form(
+                route('moonshine.posts.mass-active', $this->uriKey()),
+                fields: [
+                    HiddenIds::make($this->listComponentName()), // [tl! focus]
+                    FlexibleRender::make(__('moonshine::ui.confirm_message')),
+                ]
+            )
+                ->async()
+                ->submit('Active', ['class' => 'btn-secondary']))
+            ->bulk(),
+    ];
+}
+
+//...
+</x-code>
+
+</x-page>
diff --git a/resources/views/pages/ru/fields/hidden_ids.blade.php b/resources/views/pages/ru/fields/hidden_ids.blade.php
@@ -0,0 +1,54 @@
+<x-page
+    title="HiddenIds"
+    :sectionMenu="[
+        'Разделы' => [
+            ['url' => '#make', 'label' => 'Make'],
+            ['url' => '#use', 'label' => 'Применение'],
+        ]
+    ]"
+>
+
+<x-p>
+    Поле <em>HiddenIds</em> используется для передачи primary key выбранных элементов.
+</x-p>
+
+<x-sub-title id="make">Make</x-sub-title>
+
+<x-p>
+    В качестве параметра метод <code>make()</code> принимает название компонента.
+</x-p>
+
+<x-code language="php">
+HiddenIds::make('index-table')
+</x-code>
+
+<x-sub-title id="use">Применение</x-sub-title>
+
+<x-code language="php">
+use MoonShine\Components\FlexibleRender;
+use MoonShine\ActionButtons\ActionButton;
+use MoonShine\Fields\HiddenIds; // [tl! focus]
+
+//...
+
+public function buttons(): array
+{
+    return [
+        ActionButton::make('Active', route('moonshine.posts.mass-active', $this->uriKey()))
+            ->inModal(fn () => 'Active', fn (): string => (string) form(
+                route('moonshine.posts.mass-active', $this->uriKey()),
+                fields: [
+                    HiddenIds::make($this->listComponentName()), // [tl! focus]
+                    FlexibleRender::make(__('moonshine::ui.confirm_message')),
+                ]
+            )
+                ->async()
+                ->submit('Active', ['class' => 'btn-secondary']))
+            ->bulk(),
+    ];
+}
+
+//...
+</x-code>
+
+</x-page>