Skip to main content
Version: 4.xx.xx
Source Code

useResourceParams

useResourceParams is used to get the related parameters of the current resource such as resource, id and action. It also provides formAction to determine the action of the form and setId to set the id programmatically without having to use a separate state for it.

Usage

const {
id?, // ID of the record
setId, // Function to set the ID
resource?, // Resource object
action?, // Passed action or inferred from the route
identifier?, // Identifier value of the resource
formAction?, // Form action derived from the action
} = useResourceParams({
id?, // ID to set explicitly. Inferred from the route if not provided
action?, // Action to set explicitly. Inferred from the route if not provided
resource?, // Resource object to set explicitly. Inferred from the route if not provided
});

Inferring the id from the route

When the id is not explicitly passed, it can be inferred from the route. Inference from the route is only possible under certain conditions:

  • If there's no explicitly set resource value.
  • If there's an explicitly set resource value and it's the same as the current route.

This check is necessary to prevent the id from being inferred from a different resource.

If there's no explicit id value, no id from the route or there's a mismatch between the resource and the route, the id will be set to undefined.

Inferring the formAction from the route

The formAction is inferred from the action value.

  • If the action is a valid form action (create, edit or clone), the formAction will be set to the action.
  • Otherwise, the formAction will be set to create.

This is done to provide a more convenient way to determine the action of the form.

Return Values

resource

The resource object.

identifier

Identifier value for the current resource, this can either be the identifier property or the name property of the resource.

id

id parameter to be used in the actions.

setId

Function to set the id programmatically.

action

Current action to be performed. This can be explicitly passed via the action parameter or inferred from the route.

formAction

Apart from the action value, formAction can only be create, edit or clone. If the action is not one of these, formAction will be set to create for convenience.

API Reference

Properties

Return value

DescriptionType
resourceIResourceItem | undefined
identifierstring | undefined
idBaseKey | undefined
setId(id: BaseKey) => void
actionundefined | "list" | "create" | "edit" | "show" | "clone"
formAction"create" | "edit" | "clone"