1
Fork 0
mirror of https://github.com/pds-nest/nest.git synced 2024-11-22 13:04:19 +00:00

📔 Document useBackendViewset

This commit is contained in:
Steffo 2021-05-19 16:47:29 +02:00
parent b37eda411f
commit fdb3e64dad
Signed by: steffo
GPG key ID: 6965406171929D01

View file

@ -4,7 +4,14 @@ import ContextUser from "../contexts/ContextUser"
import makeURLSearchParams from "../utils/makeURLSearchParams" import makeURLSearchParams from "../utils/makeURLSearchParams"
export default function useBackendViewset(resourcesPath, pkName) { /**
* An hook which allows access to a full REST viewset (list, create, retrieve, edit, delete).
*
* @param resourcesPath - The path of the resource directory.
* @param pkName - The name of the primary key attribute of the elements.
* @param refreshOnStart - Whether the data should be loaded at the first startup (defaults to true).
*/
export default function useBackendViewset(resourcesPath, pkName, refreshOnStart = true) {
const { server } = useContext(ContextServer) const { server } = useContext(ContextServer)
const configured = server !== null const configured = server !== null
@ -195,14 +202,12 @@ export default function useBackendViewset(resourcesPath, pkName) {
useEffect( useEffect(
() => { () => {
if(!( if(refreshOnStart && !(loaded || running)) {
loaded || running
)) {
// noinspection JSIgnoredPromiseFromCall // noinspection JSIgnoredPromiseFromCall
refreshResources() refreshResources()
} }
}, },
[loaded, refreshResources, running], [loaded, refreshResources, running, refreshOnStart],
) )
return { return {