Маршрутизация

App Router на основе файловой системы: макеты, страницы, динамические сегменты, Link и хуки навигации.

App Router сопоставляет папки в app/ с URL и синхронизирует их с адресной строкой и историей браузера.

Страницы

Экспортируйте компонент по умолчанию из page.tsx:

app/sessions/page.tsxtsx
import { Text } from "@textjs/app";export default function SessionsPage() {  return <Text bold>Sessions</Text>;}

Макеты

Макеты оборачивают маршруты и сохраняют своё состояние при навигации.

app/layout.tsxtsx
import type { ReactNode } from "react";import { Box, Text } from "@textjs/app";import Link from "@textjs/app/link";export const metadata = { title: { default: "Acme", template: "%s · Acme" } };export default function RootLayout({ children }: { children?: ReactNode }) {  return (    <Box className="flex-col w-full h-full">      <Box className="flex-row h-1 px-1 gap-2">        <Text bold>▼ Acme</Text>        <Link href="/" shortcut="1">Home</Link>        <Link href="/sessions" shortcut="2">Sessions</Link>      </Box>      <Box className="grow">{children}</Box>    </Box>  );}

Динамические сегменты

app/sessions/[id]/page.tsxtsx
import { Text, type PageProps } from "@textjs/app";export default function SessionPage({ params }: PageProps<{ id: string }>) {  return <Text>Session {params.id}</Text>;}

<Link> может получать фокус и поддерживает горячие клавиши из одного нажатия.

PropОписание
hrefПуть назначения
shortcutКлавиша для перехода по ссылке
replaceЗамена записи в истории

useRouter

Выполняйте переходы из кода:

const router = useRouter();router.push("/sessions/new");router.back();

usePathname и useParams

Читайте текущий маршрут:

import { useParams, usePathname } from "@textjs/app/navigation";const pathname = usePathname(); // "/sessions/42"const { id } = useParams<{ id: string }>(); // "42"

Переходы назад, вперёд и прямые ссылки работают. На статическом хостинге для динамических сегментов нужно отдавать index.html как резервную страницу. Адаптер static записывает его в файл 404.html.

Изменить эту страницу на GitHub