Route
Die Übersetzung dieser Seite fehlt oder ist veraltet, daher wird sie auf Englisch angezeigt. Auf Englisch lesen
Register a screen in a Router. Use it in an app with component routes, rather than file routes.
Register a parameterized detail screen
import { Link, Route, Router, Text, VStack, routes, type RouteTo, type ScreenProps } from 'kuito';
declare module 'kuito' {
interface Routes {
index: RouteTo;
show: RouteTo<{ id: number }>;
settings: RouteTo;
}
}
function Home() {
return (
<VStack padding={16}>
<Link to={routes.show({ id: 42 })}>
<Text>Show 42</Text>
</Link>
</VStack>
);
}
function Show({ id }: ScreenProps<{ id: number }>) {
return <Text padding={16}>{`Show ${id}`}</Text>;
}
function Settings() {
return <Text padding={16}>Settings</Text>;
}
export default function App() {
return (
<Router>
<Route name="index" path="/" screen={Home} title="Home" />
<Route
name="show"
path="/show/:id"
params={{ id: Number }}
screen={Show}
title={({ id }) => `Show ${id}`}
/>
<Route name="settings" path="/settings" screen={Settings} presentation="sheet" />
</Router>
);
}Behavior
name identifies the destination, path matches links, and screen renders it. Declare parameter types with params. Route is navigation configuration rather than a visible layout container.
Continue
Read Navigation for a complete workflow. See the complete prop reference for types and documented defaults.
Referenz
Signaturen
<P extends object, R>(_props: RouteProps<P, R>): KuitoNodeTypparameter
| Name | Einschränkung | Standard |
|---|---|---|
P | object | — |
R | — | — |
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
_props | RouteProps<P, R> | Ja | — |
Rückgabe
Props: RouteProps<P, R>
Props (einschließlich geerbter Props) 10
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
name | string | Ja | Its key in routes. |
path | string | Ja | Segments, :name params and a final *name: what a deep link's path matches. |
params | { [K in keyof P]?: ParamType; } | Nein | How a link's text parses into each param; a path param left out is a string. |
screen | Component<ScreenProps<P, R>> | Ja | — |
title | string | ((params: P) => string) | Nein | The native header's title. |
presentation | Presentation | Nein | — |
backgroundColor | string | Nein | The screen's color, under the bars too; the platform's background without. |
snapPoints | readonly SnapPoint[] | Nein | A sheet route's heights, as <Sheet snapPoints> takes them; the platform's default without. |
header | false | ScreenHeader | ((params: P) => false | ScreenHeader) | Nein | The native header: false hides it; its items, large title and search otherwise (docs/navigation.md#headers). |
systemBars | SystemBarsProps | Nein | The system bars while this screen is focused, as a <SystemBars>'s props (docs/system-ui.md). |
screen — Methodensignaturen
Signaturen
(props: ScreenProps<P, R>): KuitoNodeParameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
props | ScreenProps<P, R> | Ja | — |
Rückgabe
systemBars — verschachtelte Felder
systemBars Felder
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
statusBar | StatusBarOptions | Nein | The status bar's content color, visibility and, on Android, color. |
backgroundColor | string | Nein | The root view's color, seen behind the app's views. |
navigationBarColor | string | Nein | Android: drawn behind the navigation bar. |
navigationBarButtonStyle | NavigationBarButtonStyle | Nein | Android: light buttons for a dark navigation bar, dark buttons for a light one. |
navigationBarHidden | boolean | Nein | Android: hides the navigation bar; a swipe from the edge shows it for a moment. |
immersive | boolean | Nein | Full screen: hides the status bar, the navigation bar and the home indicator, and on iOS edge swipes reach the app first. The entry's own props, and later entries, win over what it hides. |
homeIndicatorAutoHidden | boolean | Nein | iOS: lets the home indicator fade out while the user doesn't touch the screen. |
statusBar — verschachtelte Felder
statusBar Felder
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
content | StatusBarContent | Nein | The color of the status bar's text and icons. |
hidden | boolean | Nein | — |
animated | boolean | Nein | Whether changes to content, hidden and backgroundColor animate. |
transition | StatusBarTransition | Nein | iOS: how showing and hiding animates, when animated. |
backgroundColor | string | Nein | Android: drawn behind the status bar; a hex color. |
translucent | boolean | Nein | Android: false lays the app out below the status bar instead of under it. |
Generiert aus den öffentlichen TypeScript-Deklarationen: Signaturen, Props und Standardwerte stammen aus der geprüften Quelle, Beschreibungen aus deren JSDoc. Kein Standardwert ist erfunden.