ad

d docs

Author: aguingand

demo/app/Sharp/Posts/PostForm.php

@@ -9,7 +9,6 @@
 use App\Sharp\Utils\Embeds\CodeEmbed;
 use App\Sharp\Utils\Embeds\RelatedPostEmbed;
 use App\Sharp\Utils\Embeds\TableOfContentsEmbed;
-use Carbon\Carbon;
 use Code16\Sharp\Form\Eloquent\Uploads\Transformers\SharpUploadModelFormAttributeTransformer;
 use Code16\Sharp\Form\Eloquent\WithSharpFormEloquentUpdater;
 use Code16\Sharp\Form\Fields\Editor\Uploads\SharpFormEditorUpload;
@@ -30,7 +29,6 @@
 use Code16\Sharp\Form\SharpForm;
 use Code16\Sharp\Utils\Fields\FieldsContainer;
 use Illuminate\Support\Facades\Blade;
-use Illuminate\Support\Facades\Storage;
 
 class PostForm extends SharpForm
 {
@@ -110,7 +108,7 @@ public function buildFormFields(FieldsContainer $formFields): void
             )
             ->addField(
                 SharpFormHtmlField::make('publication_label')
-                    ->setLiveRefresh(linkedFields: ['author_id', 'published_at'])
+                    ->setLiveRefresh(linkedFields: ['author_id', 'published_at', 'attachments'])
                     ->setTemplate(function (array $data) {
                         if (! isset($data['published_at'])) {
                             return '';
@@ -121,9 +119,13 @@ public function buildFormFields(FieldsContainer $formFields): void
                             @if($author)
                                 by {{ $author->name }}.
                             @endif
+                            <br>
+                            {{ count($linkAttachments) }} link attachments, {{ count($fileAttachments) }} file attachments.
                         blade, [
                             'published_at' => \Carbon\Carbon::parse($data['published_at'])->isoFormat('LLLL'),
                             'author' => \App\Models\User::find($data['author_id']),
+                            'linkAttachments' => collect($data['attachments'])->where('is_link', true)->values(),
+                            'fileAttachments' => collect($data['attachments'])->where('is_link', false)->values(),
                         ]);
                     })
             )
@@ -155,23 +157,6 @@ public function buildFormFields(FieldsContainer $formFields): void
                             ->setStorageBasePath('data/posts/{id}')
                             ->addConditionalDisplay('!is_link'),
                     )
-                    ->addItemField(
-                        SharpFormHtmlField::make('document_infos')
-                            ->setLiveRefresh(linkedFields: ['document'])
-                            ->setTemplate(function (array $data) {
-                                if (! isset($data['document']['file_name'])) {
-                                    return '';
-                                }
-
-                                return sprintf(
-                                    'File uploaded at : %s',
-                                    Carbon::createFromTimestamp(
-                                        Storage::disk($data['document']['disk'])
-                                            ->lastModified($data['document']['file_name'])
-                                    )
-                                );
-                            })
-                    ),
             )
             ->when(sharp()->context()->isUpdate(), fn ($formFields) => $formFields->addField(
                 SharpFormAutocompleteRemoteField::make('author_id')
@@ -211,9 +196,7 @@ public function buildFormLayout(FormLayout $formLayout): void
                             ->withField('publication_label')
                             ->withListField('attachments', function (FormLayoutColumn $item) {
                                 $item->withFields(title: 8, is_link: 4)
-                                    ->withField('link_url')
-                                    ->withField('document')
-                                    ->withField('document_infos');
+                                    ->withField('link_url');
                             });
                     })
                     ->addColumn(6, function (FormLayoutColumn $column) {

docs/guide/form-fields/html.md

@@ -6,7 +6,7 @@ This field is read-only, and is meant to display some dynamic information in the
 
 ## Configuration
 
-### `setTemplate(string|Closure|View $template)`
+### `setTemplate(string|View|Closure $template)`
 
 Write the blade template as a string. Example:
 
@@ -35,7 +35,32 @@ SharpFormHtmlField::make('panel')
     ->setTemplate(view('sharp.form-htm-field'))
 ```
 
-### `setLiveRefresh(bool $liveRefresh = true, array $linkedeFields = [])`
+Using a closure:
+
+```php
+SharpFormHtmlField::make('panel')
+    ->setTemplate(function (array $data) {
+        return 'You have chosen:'.$data['another_form_field'].'. Date: '.$data['date'];
+    })
+```
+
+#### Accessing to other field values in the form
+
+In the template, all other field values of the form are available (alongside the Html field value). This is particularly useful when using `setLiveRefresh()` (described below).
+
+### `setLiveRefresh(bool $liveRefresh = true, ?array $linkedFields = null)`
+
+Use this method to dynamically update Html field when the user changes another field. 
+The `$linkedFields` parameter allows filtering which field to watch (without it the internal refresh endpoint is called on any field update).
+
+```php
+SharpFormHtmlField::make('total')
+    ->setLiveRefresh(linkedFields: ['products'])
+    ->setTemplate(function (array $data) {
+        return 'Total:'.collect($data['products'])
+            ->sum(fn ($product) => $product['price']);
+    })
+```
 
 ## Formatter
 

resources/js/form/components/Form.vue

@@ -103,11 +103,11 @@
             [fieldKey]: value,
         };
 
+        props.form.data = data;
+
         if((props.form.shouldRefresh(fieldKey) || inputOptions.shouldRefresh) && !inputOptions.skipRefresh) {
             refresh(data);
         }
-
-        props.form.data = data;
     }
 
     const title = useTemplateRef<HTMLElement>('title');