useNavigate

A hook to navigate programmatically.

import { useNavigate } from 'react-sprout';

let [navigate, busy, loading, navigations] = useNavigate();
  • Name
    navigate
    Type
    function
    Description

    A function to navigate programmatically.

  • Name
    busy
    Type
    boolean
    Description

    A boolean indicating whether navigations are currently busy.

  • Name
    loading
    Type
    boolean
    Description

    A boolean indicating whether navigations are currently loading.

  • Name
    navigations
    Type
    Array
    Description

    An array of busy navigations.

Navigate

navigate(options);
navigate(to, options);
  • Name
    to
    Type
    string
    Description

    The target url of the navigation

  • Name
    options
    Type
    object
    Description

    The navigation options

Navigate options

  • Name
    options.relative
    Type
    boolean
    Type
    true
    Description

    A boolean indicating whether the target url is relative to the route.

  • Name
    options.method
    Type
    string
    Type
    GET
    Description

    A string indicating the type of the navigation.

  • Name
    options.data
    Type
    any
    Description

    The data associated with the navigation

  • Name
    options.push
    Type
    boolean
    Description

    A boolean indicating whether a new entry in the history stack should be pushed.

  • Name
    options.replace
    Type
    boolean
    Description

    A boolean indicating whether the current entry in the history stack should be replaced.

  • Name
    options.title
    Type
    string
    Description

    The document title after navigation.

  • Name
    options.state
    Type
    any
    Description

    The history state after navigation.

  • Name
    options.sticky
    Type
    boolean
    Type
    false
    Description

    A boolean indicating whether the navigation is sticky.

  • Name
    options.reload
    Type
    boolean
    Type
    false
    Description

    A boolean indicating whether to reload all data for the navigation.

  • Name
    options.cache
    Type
    boolean
    Type
    false
    Description

    A boolean indicating whether the current page should be kept in the back/forward cache.

  • Name
    options.onNavigate
    Type
    function
    Description

    A callback that is invoked when a navigation is initiated.

  • Name
    options.onCanceled
    Type
    function
    Description

    A callback that is invoked when a navigation is canceled.

  • Name
    options.onNavigateStart
    Type
    function
    Description

    A callback that is invoked when a navigation is not canceled.

  • Name
    options.onActionError
    Type
    function
    Description

    A callback that is invoked when a navigation action throws an error.

  • Name
    options.onAborted
    Type
    function
    Description

    A callback that is invoked when a navigation is aborted.

  • Name
    options.onNavigateEnd
    Type
    function
    Description

    A callback that is invoked when a navigation is finished.