Українська
Аватари й канали
Крок 1. Канали
Навіщо. Список чатів показує «14:05» для сьогоднішнього повідомлення, «Yesterday», день тижня в межах останнього тижня й коротку дату для старіших; розмова показує розділювачі днів і час на годиннику; вкладення показують розміри на кшталт «1.4 MB». Канал (pipe) форматує значення всередині шаблону: шаблон пише значення, вертикальну риску та назву каналу, як фільтр. Самі функції форматування також експортуються, щоб їх могли викликати код і тести.
Що зробити. Створіть канали:
ts
import { Pipe, PipeTransform } from '@angular/core';
const DAY_MS = 86_400_000;
function startOfDay(date: Date): number {
return new Date(date.getFullYear(), date.getMonth(), date.getDate()).getTime();
}
/** "14:05" today, "Yesterday", a weekday within a week, otherwise a short date. For chat lists. */
export function shortWhen(iso: string, now = new Date()): string {
const date = new Date(iso);
const days = Math.round((startOfDay(now) - startOfDay(date)) / DAY_MS);
if (days <= 0) {
return date.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
}
if (days === 1) {
return 'Yesterday';
}
if (days < 7) {
return date.toLocaleDateString([], { weekday: 'short' });
}
return date.toLocaleDateString([], {
day: 'numeric',
month: 'short',
year: date.getFullYear() === now.getFullYear() ? undefined : 'numeric',
});
}
/** "Today", "Yesterday" or a full date. For the separators in the message list. */
export function dayLabel(iso: string, now = new Date()): string {
const date = new Date(iso);
const days = Math.round((startOfDay(now) - startOfDay(date)) / DAY_MS);
if (days === 0) {
return 'Today';
}
if (days === 1) {
return 'Yesterday';
}
return date.toLocaleDateString([], {
weekday: 'long',
day: 'numeric',
month: 'long',
year: date.getFullYear() === now.getFullYear() ? undefined : 'numeric',
});
}
/** "just now", "5 minutes ago", "yesterday", ... */
export function timeAgo(iso: string, now = Date.now()): string {
const seconds = Math.round((Date.parse(iso) - now) / 1000);
const format = new Intl.RelativeTimeFormat(undefined, { numeric: 'auto' });
const units: [Intl.RelativeTimeFormatUnit, number][] = [
['year', 31_536_000],
['month', 2_592_000],
['week', 604_800],
['day', 86_400],
['hour', 3_600],
['minute', 60],
];
for (const [unit, size] of units) {
if (Math.abs(seconds) >= size) {
return format.format(Math.round(seconds / size), unit);
}
}
return 'just now';
}
export function fileSize(bytes: number): string {
if (bytes < 1024) {
return `${bytes} B`;
}
const units = ['KB', 'MB', 'GB'];
let value = bytes / 1024;
let unit = 0;
while (value >= 1024 && unit < units.length - 1) {
value /= 1024;
unit++;
}
return `${value < 10 ? value.toFixed(1) : Math.round(value)} ${units[unit]}`;
}
@Pipe({ name: 'shortWhen' })
export class ShortWhenPipe implements PipeTransform {
transform(value: string | null | undefined): string {
return value ? shortWhen(value) : '';
}
}
@Pipe({ name: 'timeAgo' })
export class TimeAgoPipe implements PipeTransform {
transform(value: string | null | undefined): string {
return value ? timeAgo(value) : '';
}
}
@Pipe({ name: 'clock' })
export class ClockPipe implements PipeTransform {
transform(value: string | null | undefined): string {
return value
? new Date(value).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' })
: '';
}
}
@Pipe({ name: 'fileSize' })
export class FileSizePipe implements PipeTransform {
transform(value: number | null | undefined): string {
return value == null ? '' : fileSize(value);
}
}toLocaleTimeString([], { … })іIntl.RelativeTimeFormatформатують за мовою й правилами браузера – 24-годинний годинник в Україні, AM/PM у США – без таблиць перекладів у застосунку.[]означає «типова локаль користувача».- Дні рахуються між півночами (
startOfDay), а не як 24-годинні періоди: повідомлення з 23:50 о 00:10 уже «Yesterday». @Pipe({ name: 'shortWhen' })зPipeTransformзагортає функцію в канал. Канали Angular типово чисті: Angular викликаєtransformзнову, лише коли змінюється вхідне значення, тож список зі 100 чатів не форматує 100 дат за кожного відображення.timeAgo(«5 minutes ago», «yesterday») використовується для «last seen» у темах 19–21;fileSizeіFileSizePipe– для вкладень у темі 19.
Крок 2. Захищені зображення як blob-адреси
Навіщо. API віддає аватари й вкладення лише користувачам, які можуть їх бачити (тема 13): запити потребують токена носія. Звичайний <img src="/api/users/…/avatar"> не може його надіслати – браузер завантажує зображення сам, без нашого перехоплювача й без заголовка Authorization. Токен в URL потрапив би до журналів та історії браузера.
Розв’язок – завантажити зображення через HttpClient, який проходить через перехоплювач, і дати <img> blob-адресу: URL.createObjectURL(blob) повертає короткочасну адресу на кшталт blob:http://localhost:4200/0d3f…, що вказує на дані в пам’яті сторінки. Виробнича політика Content-Security-Policy дозволяє саме це через img-src 'self' blob: data: (тема 24).
Що зробити. Створіть службу:
ts
import { HttpClient } from '@angular/common/http';
import { Injectable, effect, inject, signal } from '@angular/core';
import { firstValueFrom } from 'rxjs';
import { AuthService } from '../auth/auth.service';
/**
* Avatars and attachments need the bearer token, so `<img src="/api/...">` can't load them.
* This fetches them with HttpClient (through the auth interceptor) and hands out object URLs,
* cached per URL until invalidated.
*/
@Injectable({ providedIn: 'root' })
export class BlobUrlService {
private readonly http = inject(HttpClient);
private readonly cache = new Map<string, Promise<string | null>>();
/** Bumped when an avatar changes, so components re-request it. */
private readonly versions = signal<Readonly<Record<string, number>>>({});
constructor() {
const auth = inject(AuthService);
effect(() => {
auth.sessionEpoch();
this.clear();
});
}
/** An object URL for the resource, or null if it doesn't exist. */
get(url: string): Promise<string | null> {
let entry = this.cache.get(url);
if (!entry) {
entry = firstValueFrom(this.http.get(url, { responseType: 'blob' })).then(
(blob) => URL.createObjectURL(blob),
() => {
this.cache.delete(url);
return null;
},
);
this.cache.set(url, entry);
}
return entry;
}
/** Version counter for a URL; read it in a computed/resource to reload after `invalidate`. */
version(url: string): number {
return this.versions()[url] ?? 0;
}
/** Forget a cached resource (e.g. an avatar that was replaced). */
invalidate(url: string): void {
const entry = this.cache.get(url);
this.cache.delete(url);
void entry?.then((objectUrl) => objectUrl && URL.revokeObjectURL(objectUrl));
this.versions.update((v) => ({ ...v, [url]: (v[url] ?? 0) + 1 }));
}
/** Downloads a protected file and saves it under its original name. */
async download(url: string, fileName: string): Promise<void> {
const blob = await firstValueFrom(this.http.get(url, { responseType: 'blob' }));
const objectUrl = URL.createObjectURL(blob);
const anchor = document.createElement('a');
anchor.href = objectUrl;
anchor.download = fileName;
document.body.appendChild(anchor);
anchor.click();
anchor.remove();
setTimeout(() => URL.revokeObjectURL(objectUrl), 10_000);
}
private clear(): void {
for (const entry of this.cache.values()) {
void entry.then((objectUrl) => objectUrl && URL.revokeObjectURL(objectUrl));
}
this.cache.clear();
}
}- Кеш зберігає проміси, а не адреси. П’ятдесят повідомлень від одного відправника просять той самий аватар за одне відображення; перший виклик запускає завантаження й зберігає його проміс, а решта 49 отримують цей проміс – та сама ідея single-flight, що й в оновленні токена з теми 16. Невдале завантаження видаляється з кешу, щоб наступне відображення могло спробувати ще раз, і дає
null. responseType: 'blob'змушуєHttpClientповертати тіло як двійкові дані замість розбору JSON.versions– сигнал лічильників за URL.invalidate(url)– його викликають, коли користувач змінює аватар, – скидає кешований запис, звільняє стару blob-адресу черезURL.revokeObjectURLі збільшує лічильник. Компоненти, що читаютьversion(url)усередині завантажувача на сигналах, завантажують зображення знову (наступний крок).- Під час виходу ефект, що читає
sessionEpoch, очищає весь кеш. Зображення одного користувача не повинні показуватися наступному користувачу тієї самої вкладки, а blob-адреси тримають пам’ять, доки їх не відкликано. download(url, fileName)зберігає захищене вкладення (тема 19): створює тимчасовий елемент<a download>, клацає його й відкликає адресу через десять секунд.
Крок 3. Компонент аватара
Навіщо. Аватари з’являються всюди – на панелі навігації, у списку чатів, у заголовку розмови, у списках учасників і діалогах. Компонент показує завантажене зображення, якщо воно є, а інакше кольорові ініціали, щоб кожного користувача й чат можна було впізнати навіть без фото; він також може показувати зелену крапку для користувачів, що в мережі (тема 20).
Що зробити. Створіть компонент:
angular-ts
import {
ChangeDetectionStrategy,
Component,
computed,
inject,
input,
resource,
} from '@angular/core';
import { avatarUrl } from '../../core/api/chatex-api';
import { BlobUrlService } from '../../core/media/blob-url.service';
const COLORS = [
'bg-rose-500',
'bg-orange-500',
'bg-amber-500',
'bg-emerald-500',
'bg-teal-500',
'bg-sky-500',
'bg-blue-500',
'bg-violet-500',
'bg-fuchsia-500',
];
/** A round avatar: the uploaded image (loaded as a blob) or coloured initials, plus an online dot. */
@Component({
selector: 'app-avatar',
changeDetection: ChangeDetectionStrategy.OnPush,
host: {
class: 'relative inline-flex shrink-0',
'[style.width.px]': 'size()',
'[style.height.px]': 'size()',
},
template: `
@if (image.value(); as src) {
<img [src]="src" alt="" class="size-full rounded-full object-cover" />
} @else {
<span
aria-hidden="true"
class="flex size-full items-center justify-center rounded-full font-semibold text-white select-none"
[class]="color()"
[style.font-size.px]="size() * 0.4"
>{{ initials() }}</span
>
}
@if (online()) {
<span
class="absolute right-0 bottom-0 block rounded-full bg-emerald-500 ring-2 ring-surface"
[style.width.px]="dot()"
[style.height.px]="dot()"
title="Online"
></span>
}
`,
})
export class Avatar {
private readonly blobs = inject(BlobUrlService);
readonly kind = input<'user' | 'chat'>('user');
readonly id = input<string | null | undefined>(null);
readonly name = input('');
readonly hasAvatar = input(false);
readonly size = input(40);
readonly online = input(false);
protected readonly dot = computed(() => Math.max(8, Math.round(this.size() * 0.28)));
protected readonly initials = computed(() => {
const words = this.name().trim().split(/\s+/).filter(Boolean);
const letters = words.length > 1 ? words[0][0] + words[1][0] : (words[0] ?? '?').slice(0, 2);
return letters.toUpperCase();
});
protected readonly color = computed(() => {
const key = this.id() ?? this.name();
let hash = 0;
for (let i = 0; i < key.length; i++) {
hash = (hash * 31 + key.charCodeAt(i)) | 0;
}
return COLORS[Math.abs(hash) % COLORS.length];
});
protected readonly image = resource({
params: () => {
const id = this.id();
if (!id || !this.hasAvatar()) {
return undefined;
}
const url = avatarUrl[this.kind()](id);
return { url, version: this.blobs.version(url) };
},
loader: ({ params }) => this.blobs.get(params.url),
});
}- Вхідні параметри описують, що показувати:
kind(аватар користувача чи чату),id,nameдля ініціалів,hasAvatarз DTO,sizeу пікселях іonline. DTO несутьhasAvatar, тож компонент ніколи не запитує зображення, якого не існує. hostприв’язує ширину й висоту власного елемента компонента доsize():'[style.width.px]': 'size()'.initialsбере перші літери перших двох слів («Course team» → «CT») або перші дві літери єдиного слова.colorхешує ідентифікатор (або ім’я) в один із дев’яти кольорів, тож той самий користувач завжди отримує той самий колір на кожному екрані.| 0лишає хеш 32-бітним цілим.resource({ params, loader })– це спосіб Angular завантажувати дані на сигналах.params– обчислення на кшталтcomputed: воно читаєid,hasAvatar,kindіblobs.version(url). Щоразу, коли його результат змінюється,resourceвикликаєloaderіз новими параметрами й показує результат як сигнали:value(),isLoading(),error(). Якщоparamsповертаєundefined, нічого не завантажується, аvalue()дорівнюєundefined– тут це чат без фото. Саме читанняversion(url)уparamsзмушує анульований аватар перезавантажитися.@if (image.value(); as src)показує зображення, коли воно завантажилося, а до того – ініціали (або завжди, якщо зображення немає).alt=""позначає зображення як декоративне: ім’я завжди записане поруч.
resource порівняно з Observable
Те саме можна написати з конвеєром Observable та switchMap. resource коротший для поширеного випадку «завантажувати щось щоразу, коли змінюються ці сигнали, і показувати останній результат», і сам скасовує застарілі завантаження: якщо вхідні дані змінюються, поки йде завантаження, результат старого завантаження ігнорується.
Перевірка
npm run build завершується успішно. Аватар з’являється на екрані в наступних розділах.