Українська
Поле введення
Крок 1. Поле повідомлення
Навіщо. Поле введення – найзавантаженіша частина екрана. Воно надсилає текст, показує повідомлення, на яке відповідають або яке редагують, прикріплює файли, росте разом із текстом до межі й поводиться як месенджери, до яких усі звикли: Enter надсилає, Shift+Enter починає новий рядок, Esc скасовує відповідь чи редагування – окрім телефонів, де клавіша Enter екранної клавіатури має робити новий рядок.
Вкладення завантажуються одразу після вибору, а не під час надсилання повідомлення: такий задум теми 11. Поки користувач набирає підпис, файли вже на сервері, а надсилання – це малий JSON-запит з їхніми ідентифікаторами. Тому поле введення мусить відстежувати кожне завантаження: його поступ, результат чи помилку й те, чи воно ще триває, коли користувач натискає «Send».
Сповіщення «typing…», яке поле введення надсилає іншим учасникам, з’явиться разом із клієнтом реального часу в темі 20.
Що зробити. Створіть поле введення:
angular-ts
import { HttpEventType } from '@angular/common/http';
import {
ChangeDetectionStrategy,
Component,
DestroyRef,
ElementRef,
Injector,
afterNextRender,
computed,
effect,
inject,
input,
model,
signal,
untracked,
viewChild,
} from '@angular/core';
import { Subscription } from 'rxjs';
import { AttachmentsApi } from '../../core/api/chatex-api';
import { AttachmentDto } from '../../core/api/models';
import { problemMessage } from '../../core/api/problem';
import { ToastService } from '../../core/ui/toast.service';
import { ChatMessage, MessagesStore } from '../../state/messages.store';
import { ICONS } from '../../shared/ui/icons';
import { FileSizePipe } from '../../shared/ui/pipes';
export const MAX_ATTACHMENTS = 10;
export const MAX_BODY = 4000;
/** What the server accepts; checked here only to fail fast. */
const ALLOWED_TYPES = new Set([
'image/jpeg',
'image/png',
'image/gif',
'image/webp',
'application/pdf',
'text/plain',
'application/zip',
'application/x-zip-compressed',
'application/msword',
'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
'application/vnd.ms-excel',
'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
'application/vnd.ms-powerpoint',
'application/vnd.openxmlformats-officedocument.presentationml.presentation',
'audio/mpeg',
'audio/ogg',
'video/ogg',
'video/mp4',
'video/mpeg',
]);
const ALLOWED_EXTENSIONS =
/\.(jpe?g|png|gif|webp|pdf|txt|zip|docx?|xlsx?|pptx?|mp3|mpeg|ogg|oga|ogv|mp4)$/i;
export function isAllowedFile(file: File): boolean {
return ALLOWED_TYPES.has(file.type) || (!file.type && ALLOWED_EXTENSIONS.test(file.name));
}
interface Upload {
key: number;
file: File;
progress: number;
attachment?: AttachmentDto;
error?: string;
}
let uploadKeys = 0;
/** The message box: text, reply/edit bar, and attachments uploaded as soon as they're picked. */
@Component({
selector: 'app-composer',
imports: [FileSizePipe, ICONS],
changeDetection: ChangeDetectionStrategy.OnPush,
host: { class: 'block border-t border-line bg-surface pb-safe' },
template: `
@if (editing(); as m) {
<div class="flex items-center gap-3 border-b border-line px-4 py-2 text-sm">
<svg lucidePencil class="size-4 shrink-0 text-brand-600"></svg>
<div class="min-w-0 flex-1">
<p class="font-medium text-brand-600 dark:text-brand-400">Editing message</p>
<p class="truncate text-muted">{{ m.body }}</p>
</div>
<button
type="button"
class="icon-btn size-8"
aria-label="Cancel editing"
(click)="cancel()"
>
<svg lucideX class="size-4"></svg>
</button>
</div>
} @else if (replyTo(); as m) {
<div class="flex items-center gap-3 border-b border-line px-4 py-2 text-sm">
<svg lucideReply class="size-4 shrink-0 text-brand-600"></svg>
<div class="min-w-0 flex-1">
<p class="font-medium text-brand-600 dark:text-brand-400">
Reply to {{ m.sender.displayName }}
</p>
<p class="truncate text-muted">{{ m.body || '📎 Attachment' }}</p>
</div>
<button type="button" class="icon-btn size-8" aria-label="Cancel reply" (click)="cancel()">
<svg lucideX class="size-4"></svg>
</button>
</div>
}
@if (uploads().length) {
<ul class="flex gap-2 overflow-x-auto px-3 pt-3" aria-label="Attachments">
@for (u of uploads(); track u.key) {
<li
class="relative flex w-44 shrink-0 items-center gap-2 rounded-xl border border-line bg-subtle p-2 pr-7"
[class.border-red-400]="u.error"
>
<svg lucideFile class="size-5 shrink-0 text-muted"></svg>
<div class="min-w-0 flex-1">
<p class="truncate text-xs font-medium">{{ u.file.name }}</p>
@if (u.error) {
<p class="truncate text-[11px] text-red-600 dark:text-red-400" [title]="u.error">
{{ u.error }}
</p>
} @else if (!u.attachment) {
<div class="mt-1 h-1 overflow-hidden rounded bg-line">
<div
class="h-full bg-brand-500 transition-[width]"
[style.width.%]="u.progress"
></div>
</div>
} @else {
<p class="text-[11px] text-muted">{{ u.file.size | fileSize }}</p>
}
</div>
<button
type="button"
class="absolute top-1 right-1 rounded-full p-1 text-muted hover:bg-line hover:text-fg"
[attr.aria-label]="'Remove ' + u.file.name"
(click)="removeUpload(u.key)"
>
<svg lucideX class="size-3.5"></svg>
</button>
</li>
}
</ul>
}
<form
class="flex items-end gap-1 px-2 py-2 sm:px-3"
(submit)="$event.preventDefault(); submit()"
>
@if (!editing()) {
<button
type="button"
class="icon-btn"
aria-label="Attach files"
title="Attach files"
(click)="fileInput.click()"
>
<svg lucidePaperclip class="size-5"></svg>
</button>
<input #fileInput type="file" multiple class="hidden" (change)="onFilesPicked(fileInput)" />
}
<div class="min-w-0 flex-1">
<textarea
#textarea
rows="1"
class="input max-h-40 resize-none overflow-y-auto rounded-3xl border-transparent bg-subtle px-4 py-2.5 leading-5"
[placeholder]="placeholder()"
aria-label="Message"
[maxLength]="maxBody"
[value]="text()"
(input)="onInput($any($event.target).value)"
(keydown)="onKeydown($event)"
(paste)="onPaste($event)"
></textarea>
@if (text().length > maxBody - 300) {
<p class="px-4 pt-1 text-right text-[11px] text-muted">
{{ text().length }} / {{ maxBody }}
</p>
}
</div>
<button
type="submit"
class="flex size-10 shrink-0 items-center justify-center rounded-full bg-brand-600 text-white transition-colors hover:bg-brand-700 disabled:bg-zinc-300 disabled:text-zinc-500 dark:disabled:bg-zinc-700 dark:disabled:text-zinc-400"
[disabled]="!canSubmit()"
[attr.aria-label]="editing() ? 'Save' : 'Send'"
>
@if (editing()) {
<svg lucideCheck class="size-5"></svg>
} @else {
<svg lucideSend class="size-5"></svg>
}
</button>
</form>
`,
})
export class Composer {
private readonly store = inject(MessagesStore);
private readonly attachmentsApi = inject(AttachmentsApi);
private readonly toast = inject(ToastService);
private readonly injector = inject(Injector);
private readonly subscriptions = new Map<number, Subscription>();
private readonly coarsePointer =
typeof matchMedia === 'function' && matchMedia('(pointer: coarse)').matches;
readonly chatId = input.required<string>();
readonly placeholder = input('Message');
readonly replyTo = model<ChatMessage | null>(null);
readonly editing = model<ChatMessage | null>(null);
protected readonly maxBody = MAX_BODY;
protected readonly text = signal('');
protected readonly uploads = signal<Upload[]>([]);
private readonly textarea = viewChild.required<ElementRef<HTMLTextAreaElement>>('textarea');
protected readonly canSubmit = computed(() => {
const body = this.text().trim();
if (this.editing()) {
return body.length > 0 && body !== this.editing()?.body;
}
const uploads = this.uploads();
const uploading = uploads.some((u) => !u.attachment && !u.error);
const ready = uploads.some((u) => u.attachment);
return !uploading && (body.length > 0 || ready);
});
constructor() {
// Starting an edit puts the message text into the box; a reply just focuses it.
effect(() => {
const editing = this.editing();
untracked(() => {
this.text.set(editing?.body ?? '');
if (editing) this.focus();
});
});
effect(() => {
if (this.replyTo()) untracked(() => this.focus());
});
// Grow with the text, up to max-h-40 (then it scrolls).
effect(() => {
this.text();
afterNextRender(() => this.autoResize(), { injector: this.injector });
});
// Switching chats starts with an empty box.
effect(() => {
this.chatId();
untracked(() => this.reset());
});
inject(DestroyRef).onDestroy(() => this.subscriptions.forEach((s) => s.unsubscribe()));
}
private autoResize(): void {
const element = this.textarea().nativeElement;
element.style.height = 'auto';
const border = element.offsetHeight - element.clientHeight;
element.style.height = `${element.scrollHeight + border}px`;
}
focus(): void {
setTimeout(() => this.textarea().nativeElement.focus());
}
/** Adds files from the picker, a paste or a drop. */
addFiles(files: File[]): void {
if (this.editing() || !files.length) {
return;
}
const room = MAX_ATTACHMENTS - this.uploads().length;
if (files.length > room) {
this.toast.error(`You can attach up to ${MAX_ATTACHMENTS} files per message.`);
files = files.slice(0, Math.max(0, room));
}
for (const file of files) {
if (!isAllowedFile(file)) {
this.toast.error(`“${file.name}” has a file type that can't be sent.`);
continue;
}
this.startUpload(file);
}
}
protected onInput(value: string): void {
this.text.set(value);
}
protected onKeydown(event: KeyboardEvent): void {
if (event.key === 'Escape' && (this.editing() || this.replyTo())) {
event.preventDefault();
this.cancel();
return;
}
// On touch keyboards Enter makes a new line; elsewhere Enter sends and Shift+Enter breaks the line.
if (event.key === 'Enter' && !event.shiftKey && !event.isComposing && !this.coarsePointer) {
event.preventDefault();
this.submit();
}
}
protected onPaste(event: ClipboardEvent): void {
const files = Array.from(event.clipboardData?.files ?? []);
if (files.length) {
event.preventDefault();
this.addFiles(files);
}
}
protected onFilesPicked(input: HTMLInputElement): void {
this.addFiles(Array.from(input.files ?? []));
input.value = '';
}
protected cancel(): void {
if (this.editing()) {
this.editing.set(null);
this.text.set('');
}
this.replyTo.set(null);
}
protected removeUpload(key: number): void {
this.subscriptions.get(key)?.unsubscribe();
this.subscriptions.delete(key);
this.uploads.update((list) => list.filter((u) => u.key !== key));
}
submit(): void {
if (!this.canSubmit()) {
return;
}
const body = this.text().trim();
const editing = this.editing();
if (editing) {
this.editing.set(null);
this.text.set('');
this.store.edit(editing.id, body).catch((error) => this.toast.error(error));
return;
}
const attachments = this.uploads()
.map((u) => u.attachment)
.filter((a): a is AttachmentDto => !!a);
const replyTo = this.replyTo()?.id ?? null;
this.text.set('');
this.uploads.set([]);
this.replyTo.set(null);
this.focus();
this.store.send(body, attachments, replyTo).catch((error) => this.toast.error(error));
}
private startUpload(file: File): void {
const key = ++uploadKeys;
this.uploads.update((list) => [...list, { key, file, progress: 0 }]);
const patch = (change: Partial<Upload>) =>
this.uploads.update((list) => list.map((u) => (u.key === key ? { ...u, ...change } : u)));
const subscription = this.attachmentsApi.upload(file).subscribe({
next: (event) => {
if (event.type === HttpEventType.UploadProgress && event.total) {
patch({ progress: Math.round((event.loaded / event.total) * 100) });
} else if (event.type === HttpEventType.Response && event.body) {
patch({ progress: 100, attachment: event.body });
}
},
error: (error) => patch({ error: problemMessage(error) }),
});
this.subscriptions.set(key, subscription);
}
private reset(): void {
this.subscriptions.forEach((s) => s.unsubscribe());
this.subscriptions.clear();
this.text.set('');
this.uploads.set([]);
}
}Стан:
replyToіediting– входиmodel(): сторінка розмови зв’язує їх двосторонньо ([(replyTo)]="replyTo"), тож «Reply» у списку повідомлень задає сигнал сторінки, поле введення його бачить, а коли завершує або скасовує дію, повертає сигнал наnullдля сторінки.canSubmit–computed: у режимі редагування має бути новий непорожній текст; інакше жодне завантаження не повинно тривати, і має бути текст або принаймні одне завершене завантаження. Кнопка надсилання зв’язує з ним[disabled].MAX_ATTACHMENTSіMAX_BODYповторюють обмеження сервера (тема 11), щоб відмовляти швидко;isAllowedFileповторює список дозволених типів медіа й для файлів, тип яких браузер не знає, перевіряє розширення. Остаточне рішення все одно за сервером.
Ефекти:
- Початок редагування кладе текст повідомлення в поле й ставить на нього фокус; відповідь лише ставить фокус. Обидва використовують
untracked, щоб ефект запускали тількиeditingчиreplyTo, а не сигнали, які ефект сам записує. - Автоматична зміна розміру. Після кожної зміни тексту
afterNextRenderвимірюєscrollHeightтекстової області й задає її висоту;max-h-40обмежує зростання, після чого область прокручується.Injectorпередається тому, щоafterNextRenderвикликається всередині ефекту, поза контекстом впровадження конструктора. - Перемикання чатів скидає поле й скасовує завантаження, що тривають. Той самий екземпляр
Composerлишається на екрані, коли маршрут змінюється з одного чату на інший, – Angular повторно використовує компонент і лише змінює вхідchatId, – тож це скидання необхідне.
Дії:
onKeydownнадсилає за Enter, якщо не затиснуто Shift, користувач не вводить текст методом введення (isComposing, наприклад японським) і пристрій не має грубого вказівника (сенсорний екран).addFiles(files)публічний: сторінка розмови викликає його для перетягнутих файлів, а саме поле введення – для вибраних і вставлених. Він забезпечує ліміт у десять файлів зі сповіщенням, відхиляє заборонені типи зі сповіщенням і запускає завантаження для кожного файлу.startUpload(file)підписується наAttachmentsApi.upload, який випускає події запиту (тема 16):UploadProgressоновлює відсоток,ResponseзберігаєAttachmentDto, помилка зберігає повідомлення. Кожну підписку зберігають уMapза локальним ключем, щоб видалення картки скасовувало її завантаження (unsubscribeперериває HTTP-запит).submit()у режимі редагування викликаєstore.edit; інакше збирає завершені завантаження, одразу очищає поле й викликаєstore.send– сховище показує повідомлення як очікуване.
Поступ завантаження з бекендом fetch
В Angular 22 HttpClient за замовчуванням використовує API fetch браузера, а fetch не повідомляє поступу вивантаження. Тому з типовим бекендом індикатор поступу картки лишається порожнім, доки завантаження не завершиться. Якщо потрібен індикатор, що рухається, додайте withXhr() до provideHttpClient (вправа цієї теми).
Крок 2. Тестування компонента
Навіщо. Правила поля введення містяться в його обробниках подій, тому тести відображають його й діють як користувач: вводять текст у текстову область, натискають клавіші, додають файли. TestBed.createComponent відображає компонент у jsdom; залежності замінено імітаціями (mock).
Що зробити. Створіть специфікацію. Тест сповіщення про набір тексту додасться до неї в темі 20.
ts
import { TestBed } from '@angular/core/testing';
import { NEVER } from 'rxjs';
import { AttachmentsApi } from '../../core/api/chatex-api';
import { ToastService } from '../../core/ui/toast.service';
import { MessagesStore } from '../../state/messages.store';
import { Composer, MAX_ATTACHMENTS, isAllowedFile } from './composer';
describe('Composer', () => {
let store: { send: ReturnType<typeof vi.fn>; edit: ReturnType<typeof vi.fn> };
let toast: { error: ReturnType<typeof vi.fn> };
let upload: ReturnType<typeof vi.fn>;
async function create() {
store = { send: vi.fn(async () => undefined), edit: vi.fn(async () => undefined) };
toast = { error: vi.fn() };
upload = vi.fn(() => NEVER);
TestBed.configureTestingModule({
imports: [Composer],
providers: [
{ provide: MessagesStore, useValue: store },
{ provide: AttachmentsApi, useValue: { upload } },
{ provide: ToastService, useValue: toast },
],
});
const fixture = TestBed.createComponent(Composer);
fixture.componentRef.setInput('chatId', 'chat-1');
await fixture.whenStable();
const textarea = fixture.nativeElement.querySelector('textarea') as HTMLTextAreaElement;
return { fixture, textarea };
}
function type(textarea: HTMLTextAreaElement, value: string) {
textarea.value = value;
textarea.dispatchEvent(new Event('input'));
}
function press(textarea: HTMLTextAreaElement, init: KeyboardEventInit) {
const event = new KeyboardEvent('keydown', { key: 'Enter', cancelable: true, ...init });
textarea.dispatchEvent(event);
return event;
}
it('sends on Enter and clears the box', async () => {
const { fixture, textarea } = await create();
type(textarea, ' hello ');
await fixture.whenStable();
const event = press(textarea, {});
await fixture.whenStable();
expect(event.defaultPrevented).toBe(true);
expect(store.send).toHaveBeenCalledWith('hello', [], null);
expect(textarea.value).toBe('');
});
it('keeps Shift+Enter for a new line', async () => {
const { fixture, textarea } = await create();
type(textarea, 'line one');
await fixture.whenStable();
const event = press(textarea, { shiftKey: true });
expect(event.defaultPrevented).toBe(false);
expect(store.send).not.toHaveBeenCalled();
});
it("doesn't send an empty message", async () => {
const { textarea } = await create();
type(textarea, ' ');
press(textarea, {});
expect(store.send).not.toHaveBeenCalled();
});
it(`uploads at most ${MAX_ATTACHMENTS} files per message`, async () => {
const { fixture } = await create();
const files = Array.from(
{ length: MAX_ATTACHMENTS + 2 },
(_, i) => new File(['x'], `f${i}.txt`, { type: 'text/plain' }),
);
fixture.componentInstance.addFiles(files);
expect(upload).toHaveBeenCalledTimes(MAX_ATTACHMENTS);
expect(toast.error).toHaveBeenCalled();
});
it('rejects file types the server does not accept', async () => {
const { fixture } = await create();
fixture.componentInstance.addFiles([
new File(['x'], 'run.exe', { type: 'application/x-msdownload' }),
]);
expect(upload).not.toHaveBeenCalled();
expect(toast.error).toHaveBeenCalled();
});
});
describe('isAllowedFile', () => {
it('accepts allowed types, or allowed extensions when the type is unknown', () => {
expect(isAllowedFile(new File([''], 'a.png', { type: 'image/png' }))).toBe(true);
expect(isAllowedFile(new File([''], 'notes.docx', { type: '' }))).toBe(true);
expect(isAllowedFile(new File([''], 'a.svg', { type: 'image/svg+xml' }))).toBe(false);
});
});imports: [Composer]– автономний компонент імпортується в тестовий модуль так само, як в інший компонент.fixture.componentRef.setInput('chatId', 'chat-1')задає обов’язковий вхід, як це зробив би шаблон батьківського компонента.await fixture.whenStable()чекає, поки Angular відобразить і виконає відкладені ефекти.typeіpressнадсилають справжні події DOM (input,keydown), тож прив’язки подій шаблону працюють, як у браузері.event.defaultPreventedпоказує, чи перехопило поле введення клавішу Enter.upload = vi.fn(() => NEVER)–NEVERє Observable, що ніколи нічого не випускає, тож завантаження лишаються «виконуваними», і тест може порахувати виклики.
Перевірка
powershell
npm test -- --watch=false Test Files 8 passed (8)
Tests 38 passed (38)