Українська
Список чатів
Крок 1. Панель списку
Навіщо. Панель списку – дім месенджера. Кожен рядок показує аватар чату, його назву з піктограмою для груп і каналів, час останньої активності, попередній перегляд останнього повідомлення («You: see you tomorrow», «📎 Attachment», «Message deleted») і кількість непрочитаних повідомлень. Поле пошуку фільтрує завантажені чати за назвою, а наступні сторінки завантажуються, коли користувач прокручує вниз.
Крапки присутності й «typing…» у рядках з’являться разом із клієнтом реального часу в темі 20; до того один рядок шаблону має інший відступ (жовтий).
Що зробити. Створіть панель:
angular-ts
import {
ChangeDetectionStrategy,
Component,
ElementRef,
computed,
effect,
inject,
signal,
viewChild,
} from '@angular/core';
import { RouterLink, RouterLinkActive } from '@angular/router';
import { chatTitle } from '../../core/api/models';
import { AuthService } from '../../core/auth/auth.service';
import { ChatListItem, ChatsStore } from '../../state/chats.store';
import { Avatar } from '../../shared/ui/avatar';
import { Dialogs } from '../../shared/ui/dialogs';
import { ICONS } from '../../shared/ui/icons';
import { ShortWhenPipe } from '../../shared/ui/pipes';
import { NewChatDialog } from '../new-chat/new-chat-dialog';
@Component({
selector: 'app-chat-list-pane',
imports: [RouterLink, RouterLinkActive, Avatar, ShortWhenPipe, ICONS],
changeDetection: ChangeDetectionStrategy.OnPush,
template: `
<header class="pt-safe flex items-center gap-2 px-4">
<h1 class="flex-1 py-4 text-xl font-bold tracking-tight">Chats</h1>
<button
type="button"
class="icon-btn"
aria-label="New chat"
title="New chat"
(click)="newChat()"
>
<svg lucideSquarePen class="size-5"></svg>
</button>
</header>
<div class="px-4 pb-3">
<label class="relative block">
<span class="sr-only">Filter chats</span>
<svg
lucideSearch
class="pointer-events-none absolute top-1/2 left-3 size-4 -translate-y-1/2 text-muted"
></svg>
<input
class="input border-transparent bg-subtle pl-9"
type="search"
placeholder="Search chats"
[value]="filter()"
(input)="filter.set($any($event.target).value)"
/>
</label>
</div>
<div class="min-h-0 flex-1 overflow-y-auto pb-20 md:pb-2">
@if (!store.loaded() && store.loading()) {
<ul aria-hidden="true">
@for (i of skeleton; track i) {
<li class="flex animate-pulse items-center gap-3 px-4 py-3">
<span class="size-12 rounded-full bg-subtle"></span>
<span class="flex-1 space-y-2">
<span class="block h-3 w-1/2 rounded bg-subtle"></span>
<span class="block h-3 w-3/4 rounded bg-subtle"></span>
</span>
</li>
}
</ul>
} @else if (store.loaded() && !store.items().length) {
<div class="flex flex-col items-center gap-3 px-6 py-16 text-center">
<span
class="flex size-14 items-center justify-center rounded-full bg-brand-50 text-brand-600 dark:bg-brand-950 dark:text-brand-300"
>
<svg lucideMessagesSquare class="size-7"></svg>
</span>
<p class="font-medium">No chats yet</p>
<p class="text-sm text-muted">Start a conversation or find a public group.</p>
<div class="mt-2 flex gap-2">
<button type="button" class="btn-primary" (click)="newChat()">New chat</button>
<a routerLink="/discover" class="btn-secondary">Discover</a>
</div>
</div>
} @else if (!visible().length) {
<p class="px-4 py-10 text-center text-sm text-muted">No chats match “{{ filter() }}”.</p>
}
<ul>
@for (chat of visible(); track chat.id) {
<li>
<a
[routerLink]="['/chats', chat.id]"
routerLinkActive="!bg-brand-50 dark:!bg-brand-950/60"
class="flex items-center gap-3 px-4 py-2.5 transition-colors hover:bg-subtle"
>
<app-avatar
[kind]="chat.type === 'direct' ? 'user' : 'chat'"
[id]="chat.type === 'direct' ? chat.peer?.id : chat.id"
[name]="title(chat)"
[hasAvatar]="chat.type === 'direct' ? !!chat.peer?.hasAvatar : chat.hasAvatar"
[size]="48"
/>
<span class="min-w-0 flex-1">
<span class="flex items-center gap-1.5">
@if (chat.type === 'channel') {
<svg lucideMegaphone class="size-3.5 shrink-0 text-muted"></svg>
} @else if (chat.type === 'group') {
<svg lucideUsers class="size-3.5 shrink-0 text-muted"></svg>
}
<span class="truncate font-medium">{{ title(chat) }}</span>
@if (chat.isMuted) {
<svg
lucideBellOff
class="size-3.5 shrink-0 text-muted"
aria-label="Muted"
></svg>
}
<span class="ml-auto shrink-0 pl-2 text-xs text-muted">{{
chat.lastMessage?.createdAt ?? chat.lastActivityAt | shortWhen
}}</span>
</span>
<span class="mt-0.5 flex items-center gap-2">
<span class="min-w-0 flex-1 truncate text-sm text-muted">
{{ preview(chat) }}
</span>
@if (chat.unreadCount) {
<span
class="badge"
[class]="
chat.isMuted
? 'bg-zinc-400 text-white dark:bg-zinc-600'
: 'bg-brand-600 text-white'
"
>
{{ chat.unreadCount > 99 ? '99+' : chat.unreadCount }}
</span>
}
</span>
</span>
</a>
</li>
}
</ul>
@if (store.hasMore() && !filter()) {
<div #sentinel class="flex justify-center py-4 text-muted">
@if (store.loadingMore()) {
<svg lucideLoaderCircle class="size-5 animate-spin"></svg>
}
</div>
}
</div>
`,
})
export class ChatListPane {
protected readonly store = inject(ChatsStore);
private readonly me = inject(AuthService).user;
private readonly dialogs = inject(Dialogs);
protected readonly skeleton = [1, 2, 3, 4, 5, 6];
protected readonly filter = signal('');
protected readonly visible = computed(() => {
const q = this.filter().trim().toLowerCase();
const items = this.store.items();
return q ? items.filter((c) => this.title(c).toLowerCase().includes(q)) : items;
});
private readonly sentinel = viewChild<ElementRef<HTMLElement>>('sentinel');
constructor() {
// Infinite scroll: load the next page when the bottom sentinel comes into view.
effect((onCleanup) => {
const element = this.sentinel()?.nativeElement;
if (!element) {
return;
}
const observer = new IntersectionObserver((entries) => {
if (entries.some((e) => e.isIntersecting)) {
void this.store.loadMore();
}
});
observer.observe(element);
onCleanup(() => observer.disconnect());
});
}
protected title(chat: ChatListItem): string {
return chatTitle(chat);
}
protected preview(chat: ChatListItem): string {
const last = chat.lastMessage;
if (!last) {
return chat.type === 'channel' ? 'Channel created' : 'No messages yet';
}
const prefix = last.senderId === this.me()?.id && chat.type !== 'channel' ? 'You: ' : '';
if (last.deleted) {
return `${prefix}Message deleted`;
}
return prefix + (last.body || (last.hasAttachments !== false ? '📎 Attachment' : ''));
}
protected newChat(): void {
this.dialogs.open(NewChatDialog);
}
}- Три стани перед списком: пульсуючий скелет (skeleton), поки завантажується перша сторінка (краще за індикатор: компонування не стрибає, коли надходять дані), порожній стан з «New chat» і «Discover» для нового користувача та «No chats match …», коли фільтр нічого не знаходить.
@for (chat of visible(); track chat.id)відображає рядки;visible– цеcomputedвід елементів сховища й локального сигналуfilter, тож набір у полі пошуку фільтрує без жодного запиту.[routerLink]="['/chats', chat.id]"будує посилання із сегментів;routerLinkActiveпідсвічує відкритий чат.- Прямі чати показують аватар і ім’я співрозмовника, групи й канали – власні (
[kind],[id],[hasAvatar]вибирають між ними). Назву даєchatTitleзmodels.ts. - Час використовує канал
shortWhenдля часу останнього повідомлення або, для чату без повідомлень, його останньої активності. preview(chat)пише «You: » перед власними повідомленнями користувача (не в каналах, де автор – це канал), «Message deleted» для видаленого та «📎 Attachment» для повідомлення лише з файлами.- Значок непрочитаних сірий для чатів із вимкненими сповіщеннями й обмежується «99+».
- Нескінченне прокручування. Порожній
<div #sentinel>стоїть після останнього рядка, поки є наступні сторінки.viewChild('sentinel')– сигнал, що містить елемент, коли той відображено.effectстворюєIntersectionObserver– API браузера, що повідомляє, коли елемент потрапляє у видиму область, – і викликаєstore.loadMore(), коли сторож стає видимим.onCleanupвід’єднує спостерігача, коли ефект виконується знову або компонент знищується. Це дешевше й надійніше, ніж слухати кожну подію прокручування. pb-20 md:pb-2залишає місце для нижньої панелі вкладок на телефонах.
Крок 2. Оболонка зі списком
Що зробити. Додайте до оболонки панель списку, лічильник непрочитаних і аватар користувача (нові рядки зеленим; тимчасові рядки теми 17 зникли):
angular-ts
import { ChangeDetectionStrategy, Component, computed, effect, 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 { ChatsStore } from '../../state/chats.store';
import { Avatar } from '../../shared/ui/avatar';
import { ICONS } from '../../shared/ui/icons';
import { ChatListPane } from '../chat-list/chat-list-pane';
/**
* 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, ChatListPane, Avatar, 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>
}
}
@if (item.icon === 'chats' && unread()) {
<span class="absolute -top-1 -right-1 badge bg-brand-600 text-white">{{
unreadLabel()
}}</span>
}
</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>
@if (auth.user(); as me) {
<a
routerLink="/settings"
class="rounded-full"
[title]="me.displayName"
aria-label="Your profile"
>
<app-avatar
[id]="me.id"
[name]="me.displayName"
[hasAvatar]="me.hasAvatar"
[size]="36"
/>
</a>
}
</div>
</nav>
<!-- Chat list: always visible from md up; on phones only on /chats -->
<app-chat-list-pane
class="w-full shrink-0 flex-col border-r border-line bg-surface md:flex md:w-80 xl:w-96"
[class.hidden]="!onChatsRoot()"
[class.flex]="onChatsRoot()"
/>
<!-- 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 }}
@if (item.icon === 'chats' && unread()) {
<span class="absolute top-1.5 left-1/2 ml-1.5 badge bg-brand-600 text-white">{{
unreadLabel()
}}</span>
}
</a>
}
</nav>
}
`,
})
export class Shell {
protected readonly auth = inject(AuthService);
protected readonly theme = inject(ThemeService);
private readonly chats = inject(ChatsStore);
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 readonly unread = this.chats.totalUnread;
protected readonly unreadLabel = computed(() =>
this.unread() > 99 ? '99+' : String(this.unread()),
);
constructor() {
void this.chats.loadFirst().catch(() => undefined);
effect(() => {
const count = this.unread();
document.title = count ? `(${count}) Chatex` : 'Chatex';
});
}
protected toggleTheme(): void {
this.theme.set(this.theme.isDark() ? 'light' : 'dark');
}
}<app-chat-list-pane>завжди видима відmdі вище; на телефонах вона показується лише на/chats([class.hidden]="!onChatsRoot()"), де натомість прихована головна панель.unread– це сам сигналtotalUnreadсховища, аunreadLabelобмежує його «99+» для значків на панелі навігації та панелі вкладок.- Конструктор завантажує першу сторінку чатів, коли оболонка з’являється, тобто одразу після входу.
.catch(() => undefined)не дає невдалому завантаженню стати необробленим відхиленням; список тоді просто лишається в стані завантаження, доки користувач не перезавантажить сторінку. - Заголовок вкладки показує кількість непрочитаних, «(3) Chatex», через
effect: побічну дію над документом поза шаблонами Angular. - Аватар унизу панелі навігації веде до налаштувань (тема 21).
Сторінка без чату отримує кнопку «New chat»:
angular-ts
import { ChangeDetectionStrategy, Component, inject } from '@angular/core';
import { Dialogs } from '../../shared/ui/dialogs';
import { ICONS } from '../../shared/ui/icons';
import { NewChatDialog } from '../new-chat/new-chat-dialog';
/** 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>
<button type="button" class="btn-primary" (click)="newChat()">
<svg lucidePlus class="size-4"></svg>New chat
</button>
`,
})
export class NoChatPage {
private readonly dialogs = inject(Dialogs);
protected newChat(): void {
this.dialogs.open(NewChatDialog);
}
} Крок 3. Маршрут пошуку
Що зробити. Додайте сторінку пошуку до маршрутів:
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: 'discover',
loadComponent: () =>
import('./features/discover/discover.page').then((m) => m.DiscoverPage),
},
],
},
{ path: '**', redirectTo: 'chats' },
];Перевірка
Запустіть API й клієнт і увійдіть.
- Новий користувач бачить «No chats yet» із кнопками New chat і Discover.
- Зареєструйте другого користувача (наприклад,
bob) у приватному вікні. Повернувшись до першого вікна, відкрийте New chat → Group, введіть «Course team», псевдонімcourse_team, знайдіть «bo» і виберіть Боба: з’являється фішка «Bob». Create group закриває діалог, а список показує «Course team» з помаранчевими ініціалами «CT» і «No messages yet». - New chat → Direct → знайдіть «bo» → клацніть Боба: у списку з’являється прямий чат з іменем Боба. Відкриття чату поки що не працює – його маршрут з’явиться в темі 19, тож URL повертається до
/chats. - У вікні Боба відкрийте Discover, введіть «course»: з’являється група; виберіть її й клацніть Open (Боб уже учасник). Створіть від імені Боба ще одну публічну групу й приєднайтеся до неї у вікні Аліси через Join group: з’являється сповіщення «Joined …».
- Введіть текст у полі пошуку списку: рядки фільтруються під час набору, без запитів у вкладці Network.
- У вузькому вікні список заповнює екран на
/chats, а під ним – панель вкладок.