MorphTo::defaultResource() doesn't select default resource class

[wimski]

• Laravel Version: v10.13.5
• Nova Version: 4.26.5
• PHP Version: 8.2.3

Description:

If I have a resource with a MorphTo field on which I call ->defaultResource(SomeRelatedResource::class). I expect - based on the MorphTo code below - that the type sub field is pre-filled with a default value of the given class.

MorphTo field class extract

    namespace Laravel\Nova\Fields;
    
    class MorphTo
    {
        /**
         * The default related class value for the field.
         *
         * @var (\Closure(\Laravel\Nova\Http\Requests\NovaRequest):(class-string<\Laravel\Nova\Resource>))|class-string<\Laravel\Nova\Resource>
         */
        public $defaultResourceCallable;
    
        /**
         * Set the default relation resource class to be selected.
         *
         * @param  (\Closure(\Laravel\Nova\Http\Requests\NovaRequest):(class-string<\Laravel\Nova\Resource>))|class-string<\Laravel\Nova\Resource>  $resourceClass
         * @return $this
         */
        public function defaultResource($resourceClass)
        {
            $this->defaultResourceCallable = $resourceClass;
    
            return $this;
        }
    
        /**
         * Resolve the default resource class for the field.
         *
         * @param  \Laravel\Nova\Http\Requests\NovaRequest  $request
         * @return string|void
         */
        protected function resolveDefaultResource(NovaRequest $request)
        {
            if ($request->isCreateOrAttachRequest() || $request->isResourceIndexRequest() || $request->isActionRequest()) {
                if (is_null($this->value) && $this->defaultResourceCallable instanceof Closure) {
                    $class = call_user_func($this->defaultResourceCallable, $request);
                } else {
                    $class = $this->defaultResourceCallable;
                }
    
                if (! empty($class) && class_exists($class)) {
                    return $class::uriKey();
                }
            }
        }
    
        /**
         * Prepare the field for JSON serialization.
         *
         * @return array<string, mixed>
         */
        public function jsonSerialize(): array
        {
            $resourceClass = $this->resourceClass;
    
            return with(app(NovaRequest::class), function ($request) use ($resourceClass) {
                $viewable = ! is_null($this->viewable)
                        ? $this->viewable
                        : (! is_null($resourceClass) ? $resourceClass::authorizedToViewAny($request) : true);
    
                return array_merge([
                    // ...
                    'defaultResource' => $this->resolveDefaultResource($request),
                ], parent::jsonSerialize());
            });
        }
    }

The value defaultResource is correctly passed to the front-end, but it seems it's not used properly. This is probably due to the following:

// MorphToField.vue

      if (this.shouldSelectInitialResource) {
        if (!this.resourceType && this.field.defaultResource) {
          this.resourceType = this.field.defaultResource
        }
       // ...
      }

    /**
     * Determine if we should select an initial resource when mounting this field
     */
    shouldSelectInitialResource() {
      return Boolean(
        this.editingExistingResource ||
        this.viaRelatedResource ||
        Boolean(this.field.value && this.field.defaultResource)
      )
    },

Judging from that last boolean statement, the default resource is only used when there is also a value present. In that case it can never be used as an actual 'default' resource.

[wimski]

@crynobone How is this not a bug, but an 'idea'/'feature request'?

Laravel\Nova\Fields\MorphTo

119: The default related class value for the field.

594: Set the default relation resource class to be selected.

607: Resolve the default resource class for the field.

[crynobone]

You request to change the current structure from using defaultResource + default to only use defaultResource. How is that a bug?

…

On Wed, 11 Oct 2023, 2:45 pm Wim Reckman, ***@***.***> wrote: @crynobone <https://github.com/crynobone> How is this not a bug, but an 'idea'/'feature request'? Laravel\Nova\Fields\MorphTo The *default* related *class* value for the field. Set the *default* relation *resource class* to be selected. Resolve the *default resource class* for the field. — Reply to this email directly, view it on GitHub <#5953 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AABKHJVZIX4JCFGEJBWGLDTX6Y6BLAVCNFSM6AAAAAA53OZBFWVHI2DSMVQWIX3LMV43SRDJONRXK43TNFXW4Q3PNVWWK3TUHM3TENBZGA2DE> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[wimski]

Since everything surrounding the 'default resource' setting in the MorphTo class says specifically "default resource CLASS", I'd except it to use the given class as the default resource class, regardless of any (id) value being present. There's no mention of 'this only works in conjunction with the default method'.

So either this is a bug (behaves differently than described) or the annotations are incorrect/misleading (also kind of a bug). In any case, the documentation could benefit greatly from a section describing how to use defaults for MorphTo fields.

[crynobone]

From the original PR as reference.

[wimski]

That clears things up quite a bit. Why isn't this explanation part of the documentation?

In that case my original question stands as a new feature request 🙂

[amashkarin]

I found hack, for apply desired behavior

MorphTo::make('commentable')
  ->defaultResource(Post::class)
  ->default(-1) // hack for applying defaultResource