Українська
Сповіщення й діалоги
Крок 1. Служба сповіщень
Навіщо. Багато дій завершуються коротким повідомленням: «Profile saved», «Copied to clipboard», «You no longer have access to this chat» або помилка від API. Сповіщення (toast) показує його кілька секунд, не перериваючи користувача. Будь-який компонент чи сховище має мати змогу його показати, тож сповіщення живуть у кореневій службі, а відображає їх один компонент у корені.
Що зробити. Створіть службу:
ts
import { Injectable, signal } from '@angular/core';
import { problemMessage } from '../api/problem';
export interface Toast {
id: number;
kind: 'info' | 'success' | 'error';
text: string;
}
/** Short, self-dismissing notices shown by the Toaster component. */
@Injectable({ providedIn: 'root' })
export class ToastService {
private nextId = 1;
readonly toasts = signal<Toast[]>([]);
info(text: string): void {
this.show('info', text);
}
success(text: string): void {
this.show('success', text);
}
/** Shows an error; accepts a message or a failed HTTP response. */
error(error: unknown): void {
this.show('error', typeof error === 'string' ? error : problemMessage(error));
}
dismiss(id: number): void {
this.toasts.update((list) => list.filter((t) => t.id !== id));
}
private show(kind: Toast['kind'], text: string): void {
const id = this.nextId++;
this.toasts.update((list) => [...list.slice(-3), { id, kind, text }]);
setTimeout(() => this.dismiss(id), kind === 'error' ? 6_000 : 3_500);
}
}toasts– сигнал, що містить масив. Сигнал помічає зміну лише тоді, коли отримує нове значення, томуupdateбудує новий масив ([...list, item],filter), а не додає елемент до старого. Ця незмінність – правило для кожного сигналу з колекціями в Chatex.error(error: unknown)приймає речення або будь-що, що отримавcatch; у другому випадку текст запитується вproblemMessageз теми 16. Компонент може написатиcatch (error) { this.toast.error(error); }, і користувач прочитає «This chat no longer exists.» замість статусу HTTP.- Щонайбільше чотири сповіщення одночасно (
slice(-3)зберігає останні три, потім додається нове); помилки лишаються на екрані 6 секунд, інші повідомлення – 3,5.
Крок 2. Компонент сповіщень
Навіщо. Компонент, що відображає сповіщення, знайомить із блоками керування потоком (control flow) в Angular, які використовує кожен шаблон наступних тем.
Що зробити. Створіть компонент:
angular-ts
import { ChangeDetectionStrategy, Component, inject } from '@angular/core';
import { ToastService } from '../../core/ui/toast.service';
import { ICONS } from './icons';
@Component({
selector: 'app-toaster',
imports: [ICONS],
changeDetection: ChangeDetectionStrategy.OnPush,
template: `
<div
class="pt-safe pointer-events-none fixed inset-x-0 top-0 z-[1100] flex flex-col items-center gap-2 p-3 sm:top-auto sm:bottom-0 sm:items-end sm:p-6"
aria-live="polite"
>
@for (toast of toasts.toasts(); track toast.id) {
<div
class="pointer-events-auto flex w-full max-w-sm items-start gap-3 rounded-xl border px-4 py-3 text-sm shadow-lg"
[class]="
toast.kind === 'error'
? 'border-red-200 bg-red-50 text-red-800 dark:border-red-900 dark:bg-red-950 dark:text-red-200'
: 'border-line bg-surface text-fg'
"
role="status"
>
@if (toast.kind === 'error') {
<svg lucideCircleExclamationPoint class="mt-0.5 size-4 shrink-0"></svg>
} @else if (toast.kind === 'success') {
<svg lucideCheck class="mt-0.5 size-4 shrink-0 text-emerald-500"></svg>
} @else {
<svg lucideInfo class="mt-0.5 size-4 shrink-0 text-brand-500"></svg>
}
<span class="flex-1">{{ toast.text }}</span>
<button
type="button"
class="-m-1 rounded p-1 opacity-60 hover:opacity-100"
aria-label="Dismiss"
(click)="toasts.dismiss(toast.id)"
>
<svg lucideX class="size-4"></svg>
</button>
</div>
}
</div>
`,
})
export class Toaster {
protected readonly toasts = inject(ToastService);
}@for (toast of toasts.toasts(); track toast.id)повторює блок для кожного елемента.trackкаже Angular, як розпізнати елемент між відображеннями, як ключ у словнику: коли сповіщення зникає, Angular видаляє лише його елемент, а не створює список заново. Безtrackкомпілятор відмовляється від шаблону (NG5002: @for loop must have a "track" expression).@if/@else if/@elseвибирають піктограму. Ці блоки є частиною синтаксису шаблонів з Angular 17 і замінюють старіші директиви*ngIfта*ngFor; імпортувати їх не треба.[class]="…"прив’язує атрибут class до виразу; статичні класи вclass="…"і прив’язані об’єднуються. Сповіщення про помилки червоні в обох темах.aria-live="polite"змушує зчитувачі екрана оголошувати нові сповіщення;role="status"позначає кожне.- Розташування. На телефонах сповіщення з’являються вгорі (
top-0), а від точки зламуsm– унизу праворуч (sm:top-auto sm:bottom-0 sm:items-end).z-[1100]тримає їх над діалогами. Шаблон читає сигнал служби безпосередньо:toastsпозначено якprotected, щоб його міг використовувати шаблон, але не інші класи.
Крок 3. Діалоги з Angular CDK
Навіщо. Діалоги важко зробити правильно: фокус має перейти в діалог і повернутися, коли він закривається, Esc має його закривати, сторінка під ним не повинна прокручуватися, а зчитувачі екрана мають знати, що він модальний. Component Dev Kit від команди Angular (@angular/cdk) розв’язує саме ці поведінки, не нав’язуючи вигляду – стилі лишаються нашими. Chatex використовує тут його службу Dialog, а його меню, буфер обміну й накладки – згодом.
Що зробити. Створіть тонку обгортку з типовими налаштуваннями Chatex і загальний діалог підтвердження:
angular-ts
import { DIALOG_DATA, Dialog, DialogConfig, DialogRef } from '@angular/cdk/dialog';
import { ComponentType } from '@angular/cdk/portal';
import { ChangeDetectionStrategy, Component, Injectable, inject } from '@angular/core';
import { firstValueFrom } from 'rxjs';
/** Opens app dialogs with shared styling (a centred card that fills the width on phones). */
@Injectable({ providedIn: 'root' })
export class Dialogs {
private readonly dialog = inject(Dialog);
open<R, D, C>(
component: ComponentType<C>,
data?: D,
config: DialogConfig<D, DialogRef<R, C>> = {},
): DialogRef<R, C> {
return this.dialog.open<R, D, C>(component, {
data,
autoFocus: 'first-tabbable',
restoreFocus: true,
backdropClass: 'cdk-overlay-dark-backdrop',
panelClass: 'app-dialog-panel',
maxWidth: '100vw',
...config,
});
}
async confirm(data: ConfirmData): Promise<boolean> {
const ref = this.open<boolean, ConfirmData, ConfirmDialog>(ConfirmDialog, data);
return (await firstValueFrom(ref.closed)) === true;
}
}
export interface ConfirmData {
title: string;
message: string;
confirmText?: string;
danger?: boolean;
}
@Component({
selector: 'app-confirm-dialog',
changeDetection: ChangeDetectionStrategy.OnPush,
template: `
<div class="dialog-card p-6" role="alertdialog" aria-labelledby="confirm-title">
<h2 id="confirm-title" class="text-lg font-semibold">{{ data.title }}</h2>
<p class="mt-2 text-sm text-muted">{{ data.message }}</p>
<div class="mt-6 flex flex-col-reverse gap-2 sm:flex-row sm:justify-end">
<button type="button" class="btn-secondary" (click)="ref.close(false)">Cancel</button>
<button
type="button"
[class]="data.danger ? 'btn-danger' : 'btn-primary'"
(click)="ref.close(true)"
>
{{ data.confirmText ?? 'Confirm' }}
</button>
</div>
</div>
`,
})
export class ConfirmDialog {
protected readonly data = inject<ConfirmData>(DIALOG_DATA);
protected readonly ref = inject<DialogRef<boolean>>(DialogRef);
}Dialogs.open(component, data)відкриває будь-який компонент як діалог зі спільними параметрами: фокус на першому елементі, що може його отримати, повернення фокуса потім, темне тло й клас панелі зstyles.css. Узагальнені параметри<R, D, C>– це тип результату, тип даних і тип компонента, як уDialogRef<R, C>.confirm(...)замінюєconfirm()браузера: він відкриваєConfirmDialogі перетворює його ObservableclosedнаPromise<boolean>. Викликач пишеif (await this.dialogs.confirm({ … })). Закриття через Esc або тло даєundefined, що вважається відповіддю «ні».ConfirmDialogотримує дані через токенDIALOG_DATAі закривається сам через свійDialogRef.role="alertdialog"іaria-labelledbyповідомляють допоміжним технологіям, що це таке.- CDK позиціонує діалог за допомогою таблиці стилів
overlay-prebuilt.css, якуangular.jsonзавантажує перед нашими стилями (тема 15).
Крок 4. Кореневий компонент
Що зробити. Додайте компонент сповіщень до кореневого компонента після виходу маршрутизатора, щоб сповіщення з’являлися над кожною сторінкою:
angular-ts
import { ChangeDetectionStrategy, Component, inject } from '@angular/core';
import { RouterOutlet } from '@angular/router';
import { ThemeService } from './core/ui/theme.service';
import { Toaster } from './shared/ui/toaster';
@Component({
selector: 'app-root',
imports: [RouterOutlet, Toaster],
changeDetection: ChangeDetectionStrategy.OnPush,
template: `<router-outlet /><app-toaster />`,
})
export class App {
constructor() {
// Created eagerly so the saved theme and OS changes apply on every page.
inject(ThemeService);
}
}Кореневий компонент тепер остаточний.
Перевірка
npm run build і npm test -- --watch=false завершуються успішно (19 тестів). Сповіщення й діалоги стануть видимими в наступних розділах.