Українська
Оболонка й маршрути
Крок 1. Оболонка
Навіщо. Кожна сторінка для користувача, що увійшов, живе в одній рамці – оболонці (shell). Вона пристосовується до трьох ширин за допомогою точок зламу Tailwind md (768 px) і xl (1280 px) (табл. 17.1). Одна кодова база обслуговує всі вони адаптивними класами на зразок hidden md:flex («прихований на телефонах, контейнер flex від md і вище»); окремого мобільного сайту немає.
Таблиця 17.1. Макети оболонки
| Ширина | Навігація | Панелі |
|---|---|---|
телефон (менше за md) | нижня панель вкладок: Chats, Discover, Settings (прихована всередині розмови) | по одній: список чатів на /chats, інакше сторінка |
планшет (від md до xl) | панель навігації ліворуч | список чатів поруч із головною панеллю |
настільний комп’ютер (xl і більше) | панель | ширший список; панель відомостей про чат закріплюється праворуч (тема 21) |
Список чатів – предмет теми 18. У цій темі оболонка має панель навігації, вкладки, головну панель і перемикач теми; жовті рядки тимчасові й зміняться в наступній темі.
Що зробити. Створіть оболонку:
angular-ts
import { ChangeDetectionStrategy, Component, computed, inject } from '@angular/core';
import { toSignal } from '@angular/core/rxjs-interop';
import { NavigationEnd, Router, RouterLink, RouterLinkActive, RouterOutlet } from '@angular/router';
import { filter, map } from 'rxjs';
import { AuthService } from '../../core/auth/auth.service';
import { ThemeService } from '../../core/ui/theme.service';
import { ICONS } from '../../shared/ui/icons';
/**
* The signed-in layout.
* - Phone (< md): one pane at a time. /chats shows the list, a chat fills the screen, and a bottom
* tab bar switches between Chats, Discover and Settings (hidden inside a conversation).
* - Tablet (md–xl): nav rail + chat list + main pane.
* - Desktop (≥ xl): the same with a wider list; chat info docks on the right of the conversation.
*/
@Component({
selector: 'app-shell',
imports: [RouterOutlet, RouterLink, RouterLinkActive, ICONS],
changeDetection: ChangeDetectionStrategy.OnPush,
template: `
<div class="flex h-dvh overflow-hidden">
<!-- Nav rail (tablet and desktop) -->
<nav
class="hidden w-18 shrink-0 flex-col items-center gap-2 border-r border-line bg-surface py-4 md:flex"
aria-label="Main"
>
<a
routerLink="/chats"
class="mb-4 flex size-11 items-center justify-center rounded-xl bg-brand-600 text-white"
aria-label="Chatex home"
>
<svg lucideMessagesSquare class="size-6"></svg>
</a>
@for (item of nav; track item.path) {
<a
[routerLink]="item.path"
routerLinkActive="!bg-brand-50 !text-brand-700 dark:!bg-brand-950 dark:!text-brand-300"
class="relative flex size-11 items-center justify-center rounded-xl text-muted transition-colors hover:bg-subtle hover:text-fg"
[attr.aria-label]="item.label"
[title]="item.label"
>
@switch (item.icon) {
@case ('chats') {
<svg lucideMessagesSquare class="size-5"></svg>
}
@case ('discover') {
<svg lucideCompass class="size-5"></svg>
}
@case ('settings') {
<svg lucideSettings class="size-5"></svg>
}
}
</a>
}
<div class="mt-auto flex flex-col items-center gap-2">
<button
type="button"
class="icon-btn"
(click)="toggleTheme()"
[attr.aria-label]="theme.isDark() ? 'Switch to light theme' : 'Switch to dark theme'"
[title]="theme.isDark() ? 'Light theme' : 'Dark theme'"
>
@if (theme.isDark()) {
<svg lucideSun class="size-5"></svg>
} @else {
<svg lucideMoon class="size-5"></svg>
}
</button>
</div>
</nav>
<!-- Main pane -->
<main
class="min-w-0 flex-1 flex-col md:flex"
[class.hidden]="onChatsRoot()"
[class.flex]="!onChatsRoot()"
>
<div class="flex min-h-0 flex-1 flex-col">
<router-outlet />
</div>
</main>
</div>
<!-- Bottom tab bar (phones), hidden inside a conversation -->
@if (!inConversation()) {
<nav
class="pb-safe fixed inset-x-0 bottom-0 z-30 flex border-t border-line bg-surface/95 backdrop-blur md:hidden"
aria-label="Main"
>
@for (item of nav; track item.path) {
<a
[routerLink]="item.path"
routerLinkActive="!text-brand-600 dark:!text-brand-400"
[routerLinkActiveOptions]="{
exact: item.path !== '/settings' && item.path !== '/discover',
}"
class="relative flex min-h-14 flex-1 flex-col items-center justify-center gap-0.5 text-[11px] text-muted"
>
@switch (item.icon) {
@case ('chats') {
<svg lucideMessagesSquare class="size-5"></svg>
}
@case ('discover') {
<svg lucideCompass class="size-5"></svg>
}
@case ('settings') {
<svg lucideSettings class="size-5"></svg>
}
}
{{ item.label }}
</a>
}
</nav>
}
`,
})
export class Shell {
protected readonly auth = inject(AuthService);
protected readonly theme = inject(ThemeService);
private readonly router = inject(Router);
protected readonly nav = [
{ path: '/chats', label: 'Chats', icon: 'chats' },
{ path: '/discover', label: 'Discover', icon: 'discover' },
{ path: '/settings', label: 'Settings', icon: 'settings' },
] as const;
private readonly url = toSignal(
this.router.events.pipe(
filter((e) => e instanceof NavigationEnd),
map(() => this.router.url),
),
{ initialValue: this.router.url },
);
private readonly path = computed(() => this.url().split(/[?#]/)[0]);
protected readonly onChatsRoot = computed(() => this.path() === '/chats');
protected readonly inConversation = computed(() => /^\/chats\/[^/]+/.test(this.path()));
protected toggleTheme(): void {
this.theme.set(this.theme.isDark() ? 'light' : 'dark');
}
}nav…as const– список трьох пунктів призначення.as constробить рядки літеральними типами, тож@switch (item.icon)із@case ('chats')перевіряє компілятор.routerLinkпереходить без перезавантаження сторінки;routerLinkActiveдодає класи, поки його посилання активне. Префікс!– це модифікатор important у Tailwind: кольори активного елемента перемагають кольори наведення. На панелі вкладокrouterLinkActiveOptionsзexact: trueне дає «Chats» бути активним на кожному URL/chats/....toSignal(observable, { initialValue })перетворює потік подій маршрутизатора на сигнал.router.events– це Observable кожної події навігації;filterзалишає подіїNavigationEnd, аmapбере URL.path,onChatsRootіinConversation– цеcomputedвід нього, а шаблон показує чи ховає панелі через[class.hidden]і[class.flex].toSignalсам скасовує підписку, коли компонент знищується.- Перемикач теми перемикає між світлою й темною темами через
ThemeServiceта показує сонце або місяць. Сторінка налаштувань (тема 21) також пропонує «system». <router-outlet />у головній панелі – це місце, де маршрутизатор відображає дочірні маршрути оболонки.pb-safeна панелі вкладок тримає її над індикатором «Додому» на телефонах;backdrop-blurіз напівпрозорим тлом дає вмісту змогу прокручуватися під нею.
Заглушка «Select a chat» заповнює головну панель, коли жоден чат не відкрито. Її кнопка «New chat» з’явиться разом із діалогом нового чату в темі 18, тому поки що клас порожній:
angular-ts
import { ChangeDetectionStrategy, Component } from '@angular/core';
import { ICONS } from '../../shared/ui/icons';
/** The main pane on tablets and desktops when no chat is open (phones show the list instead). */
@Component({
selector: 'app-no-chat-page',
imports: [ICONS],
changeDetection: ChangeDetectionStrategy.OnPush,
host: {
class: 'flex flex-1 flex-col items-center justify-center gap-4 bg-canvas p-8 text-center',
},
template: `
<span
class="flex size-20 items-center justify-center rounded-3xl bg-brand-50 text-brand-600 dark:bg-brand-950 dark:text-brand-300"
>
<svg lucideMessagesSquare class="size-10"></svg>
</span>
<div>
<h2 class="text-lg font-semibold">Select a chat</h2>
<p class="mt-1 text-sm text-muted">Pick a conversation from the list or start a new one.</p>
</div>
`,
})
export class NoChatPage {} Властивість host в @Component додає класи власному елементу компонента: <app-no-chat-page> стає колонкою flex, що заповнює панель.
Крок 2. Маршрути з відкладеним завантаженням
Навіщо. Маршрутизатор відображає URL на компоненти. Якби кожну сторінку було імпортовано в app.routes.ts, увесь застосунок опинився б у першому завантаженні. З відкладеним завантаженням маршрут називає функцію, що імпортує його компонент на вимогу; збирання кладе кожен такий компонент у власний чанк (chunk), який завантажується під час першого відвідування маршруту.
Що зробити. Замініть створений app.routes.ts. Пізніші теми додадуть маршрути розмови, сторінки пошуку й налаштувань.
ts
import { Routes } from '@angular/router';
import { authGuard, guestGuard } from './core/auth/guards';
export const routes: Routes = [
{
path: 'login',
canActivate: [guestGuard],
title: 'Sign in · Chatex',
loadComponent: () => import('./features/auth/login.page').then((m) => m.LoginPage),
},
{
path: 'register',
canActivate: [guestGuard],
title: 'Create account · Chatex',
loadComponent: () => import('./features/auth/register.page').then((m) => m.RegisterPage),
},
{
path: '',
canActivate: [authGuard],
loadComponent: () => import('./features/shell/shell').then((m) => m.Shell),
children: [
{ path: '', pathMatch: 'full', redirectTo: 'chats' },
{
path: 'chats',
loadComponent: () => import('./features/shell/no-chat.page').then((m) => m.NoChatPage),
},
],
},
{ path: '**', redirectTo: 'chats' },
];loadComponent: () => import('./features/auth/login.page').then((m) => m.LoginPage)– динамічнийimport()повертає Promise модуля; маршрутизатор чекає на нього й відображаєLoginPage.titleзадає заголовок вкладки браузера, поки маршрут активний.canActivate: [guestGuard]не пускає користувачів, що увійшли, на сторінки входу;[authGuard]на порожньому шляху захищає оболонку й усе під нею – дочірні маршрути успадковують захист.childrenвідображаються в<router-outlet />оболонки. Порожній дочірній шлях перенаправляє наchats, тож/показує/chats.{ path: '**', redirectTo: 'chats' }ловить невідомі URL. Маршрути зіставляються по черзі, тому шаблон із символами підстановки має стояти останнім.
Перевірка
powershell
npm run buildВивід тепер перелічує файли чанків відкладеного завантаження поряд із початковими:
Lazy chunk files | Names | Raw size | Estimated transfer size
chunk-CH2kvnUj.js | - | 45.56 kB | 10.70 kB
chunk-Cpz8IVMC.js | register-page | 5.70 kB | 2.13 kB
chunk-X5XkpZYT.js | shell | 4.71 kB | 1.83 kB
chunk-C-Q74XFF.js | no-chat-page | 862 bytes | 862 bytes
chunk-CeyQRxek.js | login-page | 128 bytes | 128 bytesБезіменний чанк містить код, спільний для кількох відкладених сторінок, наприклад бібліотеку форм.
Крок 3. Спробуйте
Що зробити. Запустіть API й клієнт (./Run.ps1 api, ./Run.ps1 web) і відкрийте http://localhost:4200.
Перевірка
- Охоронець перенаправляє
/на/login, бо сесії немає. Заголовок вкладки – «Sign in · Chatex». - Клацніть Sign in з порожніми полями: обидва поля червоніють із текстами «Enter your user name or email.» і «Enter your password.». Введіть хибний пароль для неіснуючого користувача: над формою з’являється «Wrong user name, email or password.».
- Відкрийте Create an account і зареєструйте користувача, наприклад
aliceіз паролемPassw0rd!. Застосунок переходить на/chats: панель ліворуч, «Select a chat» посередині. - Спробуйте зареєструвати
aliceще раз у приватному вікні: під іменем користувача з’являється повідомлення «This user name is already taken.» і зникає, щойно ви змінюєте поле. - Перезавантажте сторінку: ви лишаєтеся в системі. У вкладці Network
POST /api/auth/refreshтепер відповідає200, і ініціалізатор пропустив охоронця. - Клацніть місяць на панелі: тема перемикається на темну й переживає перезавантаження.
- Звузьте вікно (або скористайтеся панеллю пристроїв в інструментах розробника): панель зникає, і з’являється нижня панель вкладок. На
/chatsмакет для телефона показує лише (досі відсутній) список чатів, тож екран порожній, крім вкладок; заповнить його тема 18.
Кнопки виходу ще немає; вона з’явиться разом зі сторінкою налаштувань у темі 21. До того виходьте, видаляючи cookie chatex_refresh в інструментах розробника (Application → Cookies) і перезавантажуючи сторінку.