Українська
Нові чати й пошук
Крок 1. Пошук користувачів
Навіщо. Початок прямого чату, додавання учасників до групи (тут і в темі 21) – усе це потребує «знайти людину за іменем». GET /api/users?query= в API (тема 12) потребує щонайменше двох символів. Надсилання запиту на кожне натискання клавіші затопило б API і, що гірше, показувало б результати не в тому порядку: відповідь для «al» може надійти після відповіді для «alice». RxJS розв’язує обидві проблеми чотирма операторами.
Що зробити. Створіть повторно використовуваний компонент пошуку:
angular-ts
import {
ChangeDetectionStrategy,
Component,
DestroyRef,
computed,
inject,
input,
model,
output,
signal,
} from '@angular/core';
import { Subject, debounceTime, distinctUntilChanged, switchMap, of, catchError, map } from 'rxjs';
import { UsersApi } from '../../core/api/chatex-api';
import { UserSummaryDto } from '../../core/api/models';
import { AuthService } from '../../core/auth/auth.service';
import { Avatar } from './avatar';
import { ICONS } from './icons';
/**
* Searches users by name. In `multiple` mode it keeps a selection (shown as removable chips);
* otherwise clicking a result emits `picked`.
*/
@Component({
selector: 'app-user-search',
imports: [Avatar, ICONS],
changeDetection: ChangeDetectionStrategy.OnPush,
template: `
@if (multiple() && selected().length) {
<ul class="mb-3 flex flex-wrap gap-2" aria-label="Selected users">
@for (user of selected(); track user.id) {
<li
class="flex items-center gap-1.5 rounded-full bg-brand-50 py-1 pr-1 pl-1 text-sm text-brand-800 dark:bg-brand-950 dark:text-brand-200"
>
<app-avatar
[id]="user.id"
[name]="user.displayName"
[hasAvatar]="user.hasAvatar"
[size]="22"
/>
<span class="max-w-32 truncate">{{ user.displayName }}</span>
<button
type="button"
class="rounded-full p-0.5 hover:bg-brand-100 dark:hover:bg-brand-900"
[attr.aria-label]="'Remove ' + user.displayName"
(click)="toggle(user)"
>
<svg lucideX class="size-3.5"></svg>
</button>
</li>
}
</ul>
}
<label class="relative block">
<span class="sr-only">Search people</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 pl-9"
type="search"
placeholder="Search by name or @username"
autocomplete="off"
[value]="query()"
(input)="onQuery($any($event.target).value)"
/>
</label>
<ul
class="mt-2 max-h-72 overflow-y-auto"
role="listbox"
[attr.aria-multiselectable]="multiple()"
>
@if (searching()) {
<li class="flex justify-center py-4 text-muted">
<svg lucideLoaderCircle class="size-5 animate-spin"></svg>
</li>
} @else if (query().trim().length >= 2 && !results().length) {
<li class="py-4 text-center text-sm text-muted">No people found</li>
}
@for (user of results(); track user.id) {
<li role="option" [attr.aria-selected]="isSelected(user.id)">
<button
type="button"
class="flex w-full items-center gap-3 rounded-lg px-2 py-2 text-left hover:bg-subtle"
(click)="multiple() ? toggle(user) : picked.emit(user)"
>
<app-avatar
[id]="user.id"
[name]="user.displayName"
[hasAvatar]="user.hasAvatar"
[size]="36"
/>
<span class="min-w-0 flex-1">
<span class="block truncate text-sm font-medium">{{ user.displayName }}</span>
<span class="block truncate text-xs text-muted">@{{ user.userName }}</span>
</span>
@if (multiple()) {
<span
class="flex size-5 items-center justify-center rounded-full border"
[class]="
isSelected(user.id) ? 'border-brand-600 bg-brand-600 text-white' : 'border-line'
"
>
@if (isSelected(user.id)) {
<svg lucideCheck class="size-3.5"></svg>
}
</span>
}
</button>
</li>
}
</ul>
`,
})
export class UserSearch {
private readonly api = inject(UsersApi);
private readonly me = inject(AuthService).user;
private readonly queries = new Subject<string>();
readonly multiple = input(false);
/** Users to leave out of the results (e.g. existing members). */
readonly exclude = input<readonly string[]>([]);
readonly selected = model<UserSummaryDto[]>([]);
readonly picked = output<UserSummaryDto>();
protected readonly query = signal('');
protected readonly searching = signal(false);
private readonly found = signal<UserSummaryDto[]>([]);
protected readonly results = computed(() => {
const hidden = new Set([...this.exclude(), this.me()?.id ?? '']);
return this.found().filter((u) => !hidden.has(u.id));
});
constructor() {
const subscription = this.queries
.pipe(
map((q) => q.trim()),
debounceTime(250),
distinctUntilChanged(),
switchMap((q) => {
if (q.length < 2) {
this.searching.set(false);
return of([]);
}
this.searching.set(true);
return this.api.search(q).pipe(catchError(() => of([])));
}),
)
.subscribe((users) => {
this.searching.set(false);
this.found.set(users);
});
inject(DestroyRef).onDestroy(() => subscription.unsubscribe());
}
protected onQuery(value: string): void {
this.query.set(value);
this.queries.next(value);
}
protected isSelected(id: string): boolean {
return this.selected().some((u) => u.id === id);
}
protected toggle(user: UserSummaryDto): void {
this.selected.update((list) =>
list.some((u) => u.id === user.id) ? list.filter((u) => u.id !== user.id) : [...list, user],
);
}
}queries– цеSubject<string>: кожне натискання клавіші надсилає в нього значення поля введення (onQuery).- Конвеєр:
mapобрізає текст;debounceTime(250)чекає, доки користувач зробить паузу в 250 мс;distinctUntilChanged()відкидає запит, рівний попередньому (набрали літеру й видалили);switchMapзапускає запит HTTP і скасовує попередній, якщо новий запит надійшов раніше. Тому результати ніколи не надходять не в тому порядку.catchError(() => of([]))перетворює невдалий пошук на порожній результат, а не завершує потік. inject(DestroyRef).onDestroy(...)скасовує підписку, коли компонент знищується, – відповідникIDisposable. Без цього підписка тримала б компонент живим.- Два режими. Коли
multipleхибне, клацання користувача видаєpicked– вихідний параметр (output,output<UserSummaryDto>()): батько слухає його через(picked)="startDirect($event)". Колиmultipleістинне, клацання перемикає користувача вselected, а вибір показується як фішки, які можна видалити. selected = model<UserSummaryDto[]>([])– двосторонній вхідний параметр: батько прив’язує його синтаксисом «банан у коробці»[(selected)]="members", а зміни всередині компонента повертаються в сигнал батька.resultsприховує користувача, що увійшов, і ідентифікатори зexclude(наявних учасників, тема 21) черезcomputedнад знайденими користувачами.$any($event.target).valueчитає значення поля введення;$anyкаже компілятору шаблонів не перевіряти типи$event.target, який TypeScript знає лише якEventTarget.- Доступність. Список – це
listboxзoptionіaria-selected; поле пошуку має візуально приховану мітку (sr-only).
Крок 2. Діалог нового чату
Навіщо. Один діалог створює всі три види чатів (тема 3): прямий чат з однією людиною, групу, де пишуть усі, і канал, де публікують лише адміністратори. Групи й канали мають назву, необов’язковий опис, необов’язковий публічний псевдонім, що робить їх такими, які можна знайти, і початкових учасників.
Що зробити. Створіть діалог:
angular-ts
import { DialogRef } from '@angular/cdk/dialog';
import { ChangeDetectionStrategy, Component, inject, signal } from '@angular/core';
import { NonNullableFormBuilder, ReactiveFormsModule, Validators } from '@angular/forms';
import { Router } from '@angular/router';
import { firstValueFrom } from 'rxjs';
import { ChatsApi } from '../../core/api/chatex-api';
import { UserSummaryDto } from '../../core/api/models';
import { fieldErrors, problemMessage, toProblem } from '../../core/api/problem';
import { ChatsStore } from '../../state/chats.store';
import { ICONS } from '../../shared/ui/icons';
import { UserSearch } from '../../shared/ui/user-search';
type Tab = 'direct' | 'group' | 'channel';
/** Public handles: 5–32 characters, a letter first, then letters, digits or _. */
export const HANDLE_PATTERN = /^[a-zA-Z][a-zA-Z0-9_]{4,31}$/;
@Component({
selector: 'app-new-chat-dialog',
imports: [ReactiveFormsModule, UserSearch, ICONS],
changeDetection: ChangeDetectionStrategy.OnPush,
template: `
<div class="flex dialog-card flex-col" role="dialog" aria-labelledby="new-chat-title">
<header class="flex items-center gap-2 border-b border-line px-5 py-3">
<h2 id="new-chat-title" class="flex-1 text-lg font-semibold">New chat</h2>
<button type="button" class="-mr-2 icon-btn" aria-label="Close" (click)="ref.close()">
<svg lucideX class="size-5"></svg>
</button>
</header>
<div class="px-5 pt-4">
<div class="grid grid-cols-3 gap-1 rounded-xl bg-subtle p-1" role="tablist">
@for (t of tabs; track t.id) {
<button
type="button"
role="tab"
class="flex items-center justify-center gap-1.5 rounded-lg px-2 py-2 text-sm font-medium transition-colors"
[class]="tab() === t.id ? 'bg-surface text-fg shadow-sm' : 'text-muted hover:text-fg'"
[attr.aria-selected]="tab() === t.id"
(click)="tab.set(t.id)"
>
@switch (t.id) {
@case ('direct') {
<svg lucideUser class="size-4"></svg>
}
@case ('group') {
<svg lucideUsers class="size-4"></svg>
}
@case ('channel') {
<svg lucideMegaphone class="size-4"></svg>
}
}
{{ t.label }}
</button>
}
</div>
</div>
<div class="px-5 py-4">
@if (tab() === 'direct') {
@if (error()) {
<p
class="mb-3 rounded-lg bg-red-50 px-3 py-2 text-sm text-red-700 dark:bg-red-950 dark:text-red-300"
role="alert"
>
{{ error() }}
</p>
}
<p class="mb-3 text-sm text-muted">Find someone to message directly.</p>
<app-user-search (picked)="startDirect($event)" />
} @else {
<form [formGroup]="form" (ngSubmit)="create()" class="space-y-4" novalidate>
@if (error()) {
<p
class="rounded-lg bg-red-50 px-3 py-2 text-sm text-red-700 dark:bg-red-950 dark:text-red-300"
role="alert"
>
{{ error() }}
</p>
}
<div>
<label class="label" for="chat-title">{{
tab() === 'channel' ? 'Channel name' : 'Group name'
}}</label>
<input
id="chat-title"
class="input"
formControlName="title"
maxlength="128"
[class.input-invalid]="titleInvalid()"
/>
@if (titleInvalid()) {
<p class="field-error">A name is required.</p>
}
</div>
<div>
<label class="label" for="chat-description"
>Description <span class="font-normal text-muted">(optional)</span></label
>
<textarea
id="chat-description"
class="input min-h-20"
formControlName="description"
maxlength="1000"
></textarea>
</div>
<div>
<label class="label" for="chat-handle"
>Public handle <span class="font-normal text-muted">(optional)</span></label
>
<div class="relative">
<span
class="pointer-events-none absolute top-1/2 left-3 -translate-y-1/2 text-muted"
>@</span
>
<input
id="chat-handle"
class="input pl-7"
formControlName="publicHandle"
autocapitalize="none"
maxlength="32"
[class.input-invalid]="handleError()"
/>
</div>
@if (handleError(); as m) {
<p class="field-error">{{ m }}</p>
} @else {
<p class="mt-1 text-xs text-muted">
With a handle the {{ tab() }} is public: anyone can find and join it.
</p>
}
</div>
<div>
<span class="label">Add members</span>
<app-user-search [multiple]="true" [(selected)]="members" />
</div>
<div class="flex flex-col-reverse gap-2 pt-2 sm:flex-row sm:justify-end">
<button type="button" class="btn-secondary" (click)="ref.close()">Cancel</button>
<button type="submit" class="btn-primary" [disabled]="busy()">
@if (busy()) {
<svg lucideLoaderCircle class="size-4 animate-spin"></svg>
}
Create {{ tab() }}
</button>
</div>
</form>
}
</div>
</div>
`,
})
export class NewChatDialog {
protected readonly ref = inject(DialogRef);
private readonly api = inject(ChatsApi);
private readonly store = inject(ChatsStore);
private readonly router = inject(Router);
protected readonly tabs: { id: Tab; label: string }[] = [
{ id: 'direct', label: 'Direct' },
{ id: 'group', label: 'Group' },
{ id: 'channel', label: 'Channel' },
];
protected readonly tab = signal<Tab>('direct');
protected readonly busy = signal(false);
protected readonly error = signal<string | null>(null);
private readonly serverHandleError = signal<string | null>(null);
protected readonly members = signal<UserSummaryDto[]>([]);
protected readonly form = inject(NonNullableFormBuilder).group({
title: ['', [Validators.required, Validators.maxLength(128)]],
description: ['', Validators.maxLength(1000)],
publicHandle: ['', Validators.pattern(HANDLE_PATTERN)],
});
constructor() {
this.form.controls.publicHandle.valueChanges.subscribe(() => this.serverHandleError.set(null));
}
protected titleInvalid(): boolean {
const c = this.form.controls.title;
return c.invalid && c.touched;
}
protected handleError(): string | null {
const c = this.form.controls.publicHandle;
if (this.serverHandleError()) {
return this.serverHandleError();
}
return c.invalid && c.touched
? '5–32 characters: letters, digits and _, starting with a letter.'
: null;
}
protected async startDirect(user: UserSummaryDto): Promise<void> {
try {
const chat = await firstValueFrom(this.api.direct(user.id));
this.store.setDetails(chat);
this.ref.close();
await this.router.navigate(['/chats', chat.id]);
} catch (error) {
this.error.set(problemMessage(error));
}
}
protected async create(): Promise<void> {
if (this.form.invalid) {
this.form.markAllAsTouched();
return;
}
this.busy.set(true);
this.error.set(null);
const value = this.form.getRawValue();
try {
const chat = await firstValueFrom(
this.api.create({
type: this.tab() === 'channel' ? 'channel' : 'group',
title: value.title.trim(),
description: value.description.trim() || null,
publicHandle: value.publicHandle.trim() || null,
memberIds: this.members().map((m) => m.id),
}),
);
this.store.setDetails(chat);
this.ref.close();
await this.router.navigate(['/chats', chat.id]);
} catch (error) {
const problem = toProblem(error);
if (problem.code === 'handle_taken') {
this.serverHandleError.set(problemMessage(error));
} else {
this.serverHandleError.set(fieldErrors(error, 'publicHandle')[0] ?? null);
this.error.set(problemMessage(error));
}
} finally {
this.busy.set(false);
}
}
}- Вкладки – це три кнопки з
role="tab"іaria-selected; сигналtabвирішує, яку частину шаблону показано. - Прямий чат. Вибір користувача викликає
POST /api/chats/direct. API повертає наявний прямий чат, якщо він є (тема 10), тож діалог ніколи не створює дублікатів.store.setDetails(chat)одразу кладе чат у список, потім діалог закривається й переходить до нього. - Група або канал. Реактивна форма з обмеженнями сервера;
HANDLE_PATTERNвіддзеркалює правило псевдоніма (5–32 символи, спершу літера) і експортується для панелі відомостей про чат із теми 21. Порожні необов’язкові поля надсилаються якnull. - Помилки.
handle_takenз’являється під полем псевдоніма; будь-яка інша помилка поля псевдоніма – теж; усе решта – над формою. inject(DialogRef)дає діалогу його власний дескриптор, який використовуєref.close(). У діалога немає параметраDialogs: той, хто його відкриває (список чатів, сторінка без чату), викликаєdialogs.open(NewChatDialog).
Крок 3. Сторінка пошуку
Навіщо. Групу чи канал із публічним псевдонімом може знайти й до неї приєднатися будь-хто (тема 10). Сторінка пошуку шукає їх через GET /api/chats/search, показує попередній перегляд із кількістю учасників і приєднує одним клацанням.
Що зробити. Створіть сторінку:
angular-ts
import { ChangeDetectionStrategy, Component, DestroyRef, inject, signal } from '@angular/core';
import { Router } from '@angular/router';
import {
Subject,
catchError,
debounceTime,
distinctUntilChanged,
firstValueFrom,
map,
of,
switchMap,
} from 'rxjs';
import { ChatsApi } from '../../core/api/chatex-api';
import { ChatDto, ChatSummaryDto } from '../../core/api/models';
import { ToastService } from '../../core/ui/toast.service';
import { ChatsStore } from '../../state/chats.store';
import { Avatar } from '../../shared/ui/avatar';
import { ICONS } from '../../shared/ui/icons';
/** Search public groups and channels, preview one and join it. */
@Component({
selector: 'app-discover-page',
imports: [Avatar, ICONS],
changeDetection: ChangeDetectionStrategy.OnPush,
host: { class: 'flex min-h-0 flex-1 flex-col overflow-y-auto' },
template: `
<div class="pt-safe mx-auto w-full max-w-3xl px-4 pb-24 md:px-8 md:pb-10">
<header class="py-6">
<h1 class="text-2xl font-bold tracking-tight">Discover</h1>
<p class="mt-1 text-sm text-muted">Find public groups and channels by name or handle.</p>
</header>
<label class="relative block">
<span class="sr-only">Search public chats</span>
<svg
lucideSearch
class="pointer-events-none absolute top-1/2 left-3 size-5 -translate-y-1/2 text-muted"
></svg>
<input
class="input py-3 pl-11"
type="search"
placeholder="Search public chats"
(input)="search($any($event.target).value)"
/>
</label>
<div class="mt-6 grid gap-6 lg:grid-cols-[1fr_20rem]">
<ul class="space-y-2">
@if (searching()) {
<li class="flex justify-center py-8 text-muted">
<svg lucideLoaderCircle class="size-6 animate-spin"></svg>
</li>
} @else if (searched() && !results().length) {
<li class="card px-4 py-10 text-center text-sm text-muted">
Nothing found. Try another name.
</li>
} @else if (!searched()) {
<li class="flex flex-col items-center gap-3 card px-4 py-12 text-center">
<svg lucideCompass class="size-10 text-brand-500"></svg>
<p class="text-sm text-muted">Type at least 2 characters to search.</p>
</li>
}
@for (chat of results(); track chat.id) {
<li>
<button
type="button"
class="flex w-full items-center gap-3 card p-3 text-left transition-colors hover:border-brand-300 dark:hover:border-brand-700"
[class.!border-brand-500]="preview()?.id === chat.id"
(click)="select(chat)"
>
<app-avatar
kind="chat"
[id]="chat.id"
[name]="chat.title ?? ''"
[hasAvatar]="chat.hasAvatar"
[size]="48"
/>
<span class="min-w-0 flex-1">
<span class="flex items-center gap-1.5 font-medium">
@if (chat.type === 'channel') {
<svg lucideMegaphone class="size-4 text-muted"></svg>
} @else {
<svg lucideUsers class="size-4 text-muted"></svg>
}
<span class="truncate">{{ chat.title }}</span>
</span>
<span class="block truncate text-sm text-muted"
>@{{ chat.publicHandle }}
@if (chat.description) {
· {{ chat.description }}
}
</span>
</span>
</button>
</li>
}
</ul>
@if (preview(); as c) {
<aside class="h-fit card p-5 text-center lg:sticky lg:top-6">
<app-avatar
class="mx-auto"
kind="chat"
[id]="c.id"
[name]="c.title ?? ''"
[hasAvatar]="c.hasAvatar"
[size]="80"
/>
<h2 class="mt-3 text-lg font-semibold">{{ c.title }}</h2>
<p class="text-sm text-muted">
@{{ c.publicHandle }} · {{ c.memberCount }}
{{ c.type === 'channel' ? 'subscribers' : 'members' }}
</p>
@if (c.description) {
<p class="mt-3 text-sm whitespace-pre-wrap">{{ c.description }}</p>
}
<button
type="button"
class="mt-5 btn-primary w-full"
[disabled]="busy()"
(click)="joinOrOpen(c)"
>
@if (busy()) {
<svg lucideLoaderCircle class="size-4 animate-spin"></svg>
}
{{ c.myRole ? 'Open' : 'Join ' + c.type }}
</button>
</aside>
}
</div>
</div>
`,
})
export class DiscoverPage {
private readonly api = inject(ChatsApi);
private readonly chats = inject(ChatsStore);
private readonly router = inject(Router);
private readonly toast = inject(ToastService);
private readonly queries = new Subject<string>();
protected readonly results = signal<ChatSummaryDto[]>([]);
protected readonly searching = signal(false);
protected readonly searched = signal(false);
protected readonly preview = signal<ChatDto | null>(null);
protected readonly busy = signal(false);
constructor() {
const subscription = this.queries
.pipe(
map((q) => q.trim()),
debounceTime(300),
distinctUntilChanged(),
switchMap((q) => {
if (q.length < 2) {
this.searched.set(false);
this.searching.set(false);
return of([]);
}
this.searching.set(true);
return this.api.search(q).pipe(
map((list) => {
this.searched.set(true);
return list;
}),
catchError((error) => {
this.toast.error(error);
return of([]);
}),
);
}),
)
.subscribe((list) => {
this.searching.set(false);
this.results.set(list);
});
inject(DestroyRef).onDestroy(() => subscription.unsubscribe());
}
protected search(value: string): void {
this.queries.next(value);
}
protected async select(chat: ChatSummaryDto): Promise<void> {
try {
const details = await firstValueFrom(this.api.get(chat.id));
this.preview.set(details);
// On narrow screens the preview sits below the list; bring it into view.
if (window.innerWidth < 1024) {
setTimeout(() =>
document.querySelector('aside.card')?.scrollIntoView({ behavior: 'smooth' }),
);
}
} catch (error) {
this.toast.error(error);
}
}
protected async joinOrOpen(chat: ChatDto): Promise<void> {
if (chat.myRole) {
this.chats.setDetails(chat);
await this.router.navigate(['/chats', chat.id]);
return;
}
this.busy.set(true);
try {
const joined = await firstValueFrom(this.api.join(chat.id));
this.chats.setDetails(joined);
this.toast.success(`Joined ${joined.title ?? 'chat'}`);
await this.router.navigate(['/chats', joined.id]);
} catch (error) {
this.toast.error(error);
} finally {
this.busy.set(false);
}
}
}- Конвеєр пошуку – той самий, що й у пошуку користувачів, із затримкою 300 мс і сповіщенням про помилки.
searchedвідрізняє «нічого не знайдено» від «ще нічого не шукали». select(chat)завантажує повнийChatDto– результат пошуку не має кількості учасників і ролі. На вузьких екранах попередній перегляд розташований під списком, тому сторінка прокручує його у видиму область.joinOrOpen(chat)відкриває чат, учасником якого користувач уже є (заданоmyRole), а інакше приєднує його черезPOST /api/chats/{id}/join, додає до сховища черезsetDetails, показує сповіщення про успіх і переходить до нього.[class.!border-brand-500]– прив’язка класу з модифікатором important від Tailwind – підсвічує вибраний результат.
Перевірка
npm run build завершується успішно. Діалог і сторінка стануть досяжними в наступному розділі.