expo-router
Version:
Expo Router is a file-based router for React Native and web applications.
256 lines • 12.6 kB
TypeScript
import { DefaultNavigatorOptions, ParamListBase, TabActionHelpers, TabNavigationState, TabRouterOptions } from '@react-navigation/native';
import { ReactNode } from 'react';
import { ViewProps } from 'react-native';
import { ExpoTabsScreenOptions, TabNavigationEventMap, TabsContextValue } from './TabContext';
import { ScreenTrigger } from './common';
export * from './TabContext';
export * from './TabList';
export * from './TabSlot';
export * from './TabTrigger';
/**
* Options to provide to the Tab Router.
*/
export type UseTabsOptions = Omit<DefaultNavigatorOptions<ParamListBase, any, TabNavigationState<any>, ExpoTabsScreenOptions, TabNavigationEventMap, any>, 'children'> & {
backBehavior?: TabRouterOptions['backBehavior'];
};
export type TabsProps = ViewProps & {
/** Forward props to child component and removes the extra `<View>`. Useful for custom wrappers. */
asChild?: boolean;
options?: UseTabsOptions;
};
/**
* Root component for the headless tabs.
*
* @see [`useTabsWithChildren`](#usetabswithchildrenoptions) for a hook version of this component.
* @example
* ```tsx
* <Tabs>
* <TabSlot />
* <TabList>
* <TabTrigger name="home" href="/" />
* </TabList>
* </Tabs>
* ```
*/
export declare function Tabs(props: TabsProps): import("react").JSX.Element;
export type UseTabsWithChildrenOptions = UseTabsOptions & {
children: ReactNode;
};
export type UseTabsWithTriggersOptions = UseTabsOptions & {
triggers: ScreenTrigger[];
};
/**
* Hook version of `Tabs`. The returned NavigationContent component
* should be rendered.
*
* @see [`Tabs`](#tabs) for the component version of this hook.
* @example
* ```tsx
* export function MyTabs({ children }) {
* const { NavigationContent } = useTabsWithChildren({ children })
*
* return <NavigationContent />
* }
* ```
*/
export declare function useTabsWithChildren(options: UseTabsWithChildrenOptions): {
state: TabNavigationState<any>;
navigation: {
dispatch(action: Readonly<{
type: string;
payload?: object | undefined;
source?: string | undefined;
target?: string | undefined;
}> | ((state: Readonly<Readonly<{
key: string;
index: number;
routeNames: string[];
history?: unknown[] | undefined;
routes: import("@react-navigation/native").NavigationRoute<ParamListBase, string>[];
type: string;
stale: false;
}>>) => Readonly<{
type: string;
payload?: object | undefined;
source?: string | undefined;
target?: string | undefined;
}>)): void;
navigate<RouteName extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
navigate<RouteName_1 extends string>(options: {
name: string;
params: object | undefined;
path?: string | undefined;
merge?: boolean | undefined;
}): void;
navigateDeprecated<RouteName_2 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
navigateDeprecated<RouteName_3 extends string>(options: {
name: string;
params: object | undefined;
merge?: boolean | undefined;
}): void;
preload<RouteName_4 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
reset(state: Readonly<{
key: string;
index: number;
routeNames: string[];
history?: unknown[] | undefined;
routes: import("@react-navigation/native").NavigationRoute<ParamListBase, string>[];
type: string;
stale: false;
}> | import("@react-navigation/native").PartialState<Readonly<{
key: string;
index: number;
routeNames: string[];
history?: unknown[] | undefined;
routes: import("@react-navigation/native").NavigationRoute<ParamListBase, string>[];
type: string;
stale: false;
}>>): void;
goBack(): void;
isFocused(): boolean;
canGoBack(): boolean;
getId(): string | undefined;
getParent<T = import("@react-navigation/native").NavigationHelpers<ParamListBase, {}> | undefined>(id?: string | undefined): T;
getState(): Readonly<{
key: string;
index: number;
routeNames: string[];
history?: unknown[] | undefined;
routes: import("@react-navigation/native").NavigationRoute<ParamListBase, string>[];
type: string;
stale: false;
}>;
setStateForNextRouteNamesChange(state: Readonly<{
key: string;
index: number;
routeNames: string[];
history?: unknown[] | undefined;
routes: import("@react-navigation/native").NavigationRoute<ParamListBase, string>[];
type: string;
stale: false;
}> | import("@react-navigation/native").PartialState<Readonly<{
key: string;
index: number;
routeNames: string[];
history?: unknown[] | undefined;
routes: import("@react-navigation/native").NavigationRoute<ParamListBase, string>[];
type: string;
stale: false;
}>>): void;
} & import("@react-navigation/native").PrivateValueStore<[ParamListBase, unknown, unknown]> & import("@react-navigation/native").EventEmitter<TabNavigationEventMap> & {
setParams<RouteName_5 extends string>(params: Partial<object | undefined>): void;
} & TabActionHelpers<ParamListBase>;
describe: (route: import("@react-navigation/native").RouteProp<ParamListBase, string>, placeholder: boolean) => import("@react-navigation/native").Descriptor<import("./TabContext").ExpoTabsNavigatorScreenOptions, Omit<{
dispatch(action: Readonly<{
type: string;
payload?: object | undefined;
source?: string | undefined;
target?: string | undefined;
}> | ((state: Readonly<TabNavigationState<any>>) => Readonly<{
type: string;
payload?: object | undefined;
source?: string | undefined;
target?: string | undefined;
}>)): void;
navigate<RouteName_6 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
navigate<RouteName_7 extends string>(options: {
name: string;
params: object | undefined;
path?: string | undefined;
merge?: boolean | undefined;
}): void;
navigateDeprecated<RouteName_8 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
navigateDeprecated<RouteName_9 extends string>(options: {
name: string;
params: object | undefined;
merge?: boolean | undefined;
}): void;
preload<RouteName_10 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
reset(state: TabNavigationState<any> | import("@react-navigation/native").PartialState<TabNavigationState<any>>): void;
goBack(): void;
isFocused(): boolean;
canGoBack(): boolean;
getId(): string | undefined;
getParent<T_1 = import("@react-navigation/native").NavigationHelpers<ParamListBase, {}> | undefined>(id?: string | undefined): T_1;
getState(): TabNavigationState<any>;
setStateForNextRouteNamesChange(state: TabNavigationState<any> | import("@react-navigation/native").PartialState<TabNavigationState<any>>): void;
} & import("@react-navigation/native").PrivateValueStore<[ParamListBase, unknown, unknown]>, "getParent"> & {
getParent<T_2 = import("@react-navigation/native").NavigationProp<ParamListBase, string, undefined, Readonly<{
key: string;
index: number;
routeNames: string[];
history?: unknown[] | undefined;
routes: import("@react-navigation/native").NavigationRoute<ParamListBase, string>[];
type: string;
stale: false;
}>, {}, {}> | undefined>(id?: string | undefined): T_2;
setParams(params: Partial<object | undefined>): void;
setOptions(options: Partial<import("./TabContext").ExpoTabsNavigatorScreenOptions>): void;
} & import("@react-navigation/native").EventConsumer<TabNavigationEventMap & import("@react-navigation/native").EventMapCore<TabNavigationState<any>>> & import("@react-navigation/native").PrivateValueStore<[ParamListBase, string, TabNavigationEventMap]> & TabActionHelpers<ParamListBase>, import("@react-navigation/native").RouteProp<ParamListBase, string>>;
descriptors: Record<string, import("@react-navigation/native").Descriptor<import("./TabContext").ExpoTabsNavigatorScreenOptions, Omit<{
dispatch(action: Readonly<{
type: string;
payload?: object | undefined;
source?: string | undefined;
target?: string | undefined;
}> | ((state: Readonly<TabNavigationState<any>>) => Readonly<{
type: string;
payload?: object | undefined;
source?: string | undefined;
target?: string | undefined;
}>)): void;
navigate<RouteName_11 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
navigate<RouteName_12 extends string>(options: {
name: string;
params: object | undefined;
path?: string | undefined;
merge?: boolean | undefined;
}): void;
navigateDeprecated<RouteName_13 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
navigateDeprecated<RouteName_14 extends string>(options: {
name: string;
params: object | undefined;
merge?: boolean | undefined;
}): void;
preload<RouteName_15 extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
reset(state: TabNavigationState<any> | import("@react-navigation/native").PartialState<TabNavigationState<any>>): void;
goBack(): void;
isFocused(): boolean;
canGoBack(): boolean;
getId(): string | undefined;
getParent<T_3 = import("@react-navigation/native").NavigationHelpers<ParamListBase, {}> | undefined>(id?: string | undefined): T_3;
getState(): TabNavigationState<any>;
setStateForNextRouteNamesChange(state: TabNavigationState<any> | import("@react-navigation/native").PartialState<TabNavigationState<any>>): void;
} & import("@react-navigation/native").PrivateValueStore<[ParamListBase, unknown, unknown]>, "getParent"> & {
getParent<T_4 = import("@react-navigation/native").NavigationProp<ParamListBase, string, undefined, Readonly<{
key: string;
index: number;
routeNames: string[];
history?: unknown[] | undefined;
routes: import("@react-navigation/native").NavigationRoute<ParamListBase, string>[];
type: string;
stale: false;
}>, {}, {}> | undefined>(id?: string | undefined): T_4;
setParams(params: Partial<object | undefined>): void;
setOptions(options: Partial<import("./TabContext").ExpoTabsNavigatorScreenOptions>): void;
} & import("@react-navigation/native").EventConsumer<TabNavigationEventMap & import("@react-navigation/native").EventMapCore<TabNavigationState<any>>> & import("@react-navigation/native").PrivateValueStore<[ParamListBase, string, TabNavigationEventMap]> & TabActionHelpers<ParamListBase>, import("@react-navigation/native").RouteProp<ParamListBase, string>>>;
NavigationContent: ({ children }: {
children: ReactNode;
}) => import("react/jsx-runtime").JSX.Element;
};
/**
* Alternative hook version of `Tabs` that uses explicit triggers
* instead of `children`.
*
* @see [`Tabs`](#tabs) for the component version of this hook.
* @example
* ```tsx
* export function MyTabs({ children }) {
* const { NavigationContent } = useTabsWithChildren({ triggers: [] })
*
* return <NavigationContent />
* }
* ```
*/
export declare function useTabsWithTriggers(options: UseTabsWithTriggersOptions): TabsContextValue;
//# sourceMappingURL=Tabs.d.ts.map