@react-navigation/core
Version:
Core utilities for building navigators
102 lines • 4.42 kB
TypeScript
import { type NavigationAction, type NavigationState, type ParamListBase, type Router } from '@react-navigation/routers';
import * as React from 'react';
import { type NavigationHelpers, PrivateValueStore } from './types';
import type { NavigationEventEmitter } from './useEventEmitter';
type Options<State extends NavigationState, Action extends NavigationAction> = {
id: string | undefined;
onAction: (action: NavigationAction) => boolean;
getState: () => State;
emitter: NavigationEventEmitter<any>;
router: Router<State, Action>;
stateRef: React.RefObject<State | null>;
};
/**
* Navigation object with helper methods to be used by a navigator.
* This object includes methods for common actions as well as methods the parent screen's navigation object.
*/
export declare function useNavigationHelpers<State extends NavigationState, ActionHelpers extends Record<string, () => void>, Action extends NavigationAction, EventMap extends Record<string, any>>({ id: navigatorId, onAction, getState, emitter, router, stateRef, }: Options<State, Action>): {
dispatch(action: Readonly<{
type: string;
payload?: object;
source?: string;
target?: string;
}> | ((state: Readonly<Readonly<{
key: string;
index: number;
routeNames: string[];
history?: unknown[];
routes: import("@react-navigation/routers").NavigationRoute<ParamListBase, string>[];
type: string;
stale: false;
}>>) => NavigationAction)): void;
navigate<RouteName extends string>(...args: RouteName extends unknown ? [screen: RouteName, params?: object | undefined, options?: {
merge?: boolean;
pop?: boolean;
} | undefined] : never): void;
navigate<RouteName extends string>(options: RouteName extends unknown ? {
name: RouteName;
params: object | undefined;
path?: string;
merge?: boolean;
pop?: boolean;
} : never): void;
navigateDeprecated<RouteName extends string>(...args: RouteName extends unknown ? [screen: RouteName, params?: object | undefined] : never): void;
navigateDeprecated<RouteName extends string>(options: RouteName extends unknown ? {
name: RouteName;
params: object | undefined;
merge?: boolean;
} : never): void;
preload<RouteName extends string>(...args: RouteName extends unknown ? [screen: RouteName, params?: object | undefined] : never): void;
reset(state: Readonly<{
key: string;
index: number;
routeNames: string[];
history?: unknown[];
routes: import("@react-navigation/routers").NavigationRoute<ParamListBase, string>[];
type: string;
stale: false;
}> | import("@react-navigation/routers").PartialState<Readonly<{
key: string;
index: number;
routeNames: string[];
history?: unknown[];
routes: import("@react-navigation/routers").NavigationRoute<ParamListBase, string>[];
type: string;
stale: false;
}>>): void;
goBack(): void;
isFocused(): boolean;
canGoBack(): boolean;
getId(): string | undefined;
getParent<T = NavigationHelpers<ParamListBase, {}> | undefined>(id?: string): T;
getState(): Readonly<{
key: string;
index: number;
routeNames: string[];
history?: unknown[];
routes: import("@react-navigation/routers").NavigationRoute<ParamListBase, string>[];
type: string;
stale: false;
}>;
setStateForNextRouteNamesChange(state: Readonly<{
key: string;
index: number;
routeNames: string[];
history?: unknown[];
routes: import("@react-navigation/routers").NavigationRoute<ParamListBase, string>[];
type: string;
stale: false;
}> | import("@react-navigation/routers").PartialState<Readonly<{
key: string;
index: number;
routeNames: string[];
history?: unknown[];
routes: import("@react-navigation/routers").NavigationRoute<ParamListBase, string>[];
type: string;
stale: false;
}>>): void;
} & PrivateValueStore<[ParamListBase, unknown, unknown]> & import("./types").EventEmitter<EventMap> & {
setParams<RouteName extends string>(params: Partial<object | undefined>): void;
} & ActionHelpers;
export {};
//# sourceMappingURL=useNavigationHelpers.d.ts.map