Українська
Вхід і реєстрація
Крок 1. Макет із проєкцією вмісту
Навіщо. Сторінки входу й реєстрації мають спільну рамку: центровану картку під логотипом Chatex, заголовок і підзаголовок. Компонент макета містить рамку, а кожна сторінка її заповнює.
Що зробити. Створіть макет:
angular-ts
import { ChangeDetectionStrategy, Component, input } from '@angular/core';
import { ICONS } from '../../shared/ui/icons';
/** Centred card used by the sign-in and register pages. */
@Component({
selector: 'app-auth-layout',
imports: [ICONS],
changeDetection: ChangeDetectionStrategy.OnPush,
template: `
<main
class="flex min-h-dvh items-start justify-center bg-gradient-to-br from-brand-50 via-canvas to-canvas px-4 py-10 sm:items-center dark:from-brand-950/40"
>
<div class="w-full max-w-md">
<div class="mb-8 flex flex-col items-center gap-3 text-center">
<span
class="flex size-14 items-center justify-center rounded-2xl bg-brand-600 text-white shadow-lg shadow-brand-600/30"
>
<svg lucideMessagesSquare class="size-7"></svg>
</span>
<h1 class="text-2xl font-bold tracking-tight">{{ heading() }}</h1>
<p class="text-sm text-muted">{{ subheading() }}</p>
</div>
<div class="card p-6 shadow-sm sm:p-8">
<ng-content />
</div>
</div>
</main>
`,
})
export class AuthLayout {
readonly heading = input.required<string>();
readonly subheading = input('');
}input.required<string>()оголошує обов’язковий вхідний параметр (input) – параметр, який батько задає у своєму шаблоні (heading="Welcome back"). Вхідний параметр – це сигнал лише для читання: шаблон читаєheading().input('')оголошує необов’язковий із типовим значенням. Компілятор перевіряє, що кожне використання<app-auth-layout>задаєheading.<ng-content />позначає, де з’являється вміст між<app-auth-layout>і</app-auth-layout>– це проєкція вмісту (content projection), відповідник@Bodyу макеті Razor абоChildContentу компоненті Blazor.- Подвійні фігурні дужки в шаблоні – це інтерполяція: вони вставляють значення виразу як текст, екранований для HTML. Angular ніколи не трактує інтерпольований текст як розмітку, що захищає від міжсайтового скриптингу.
Крок 2. Сторінка входу й реактивні форми
Навіщо. В Angular є два API форм. Форми на основі шаблону прив’язують поля введення до полів через ngModel і тримають логіку в шаблоні. Реактивні форми будують модель форми в класі – елементи керування, валідатори, значення – і прив’язують до неї шаблон. Модель типізована, тестується без DOM і легко скидається чи заповнюється з коду, тому Chatex використовує реактивні форми всюди.
Що зробити. Створіть сторінку:
angular-ts
import { ChangeDetectionStrategy, Component, inject, input, signal } from '@angular/core';
import { NonNullableFormBuilder, ReactiveFormsModule, Validators } from '@angular/forms';
import { Router, RouterLink } from '@angular/router';
import { problemMessage } from '../../core/api/problem';
import { AuthService } from '../../core/auth/auth.service';
import { ICONS } from '../../shared/ui/icons';
import { AuthLayout } from './auth-layout';
@Component({
selector: 'app-login-page',
imports: [ReactiveFormsModule, RouterLink, AuthLayout, ICONS],
changeDetection: ChangeDetectionStrategy.OnPush,
template: `
<app-auth-layout heading="Welcome back" subheading="Sign in to continue to Chatex">
<form [formGroup]="form" (ngSubmit)="submit()" 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="login">User name or email</label>
<input
id="login"
class="input"
formControlName="login"
autocomplete="username"
autocapitalize="none"
[class.input-invalid]="invalid('login')"
/>
@if (invalid('login')) {
<p class="field-error">Enter your user name or email.</p>
}
</div>
<div>
<label class="label" for="password">Password</label>
<input
id="password"
class="input"
type="password"
formControlName="password"
autocomplete="current-password"
[class.input-invalid]="invalid('password')"
/>
@if (invalid('password')) {
<p class="field-error">Enter your password.</p>
}
</div>
<button type="submit" class="btn-primary w-full" [disabled]="busy()">
@if (busy()) {
<svg lucideLoaderCircle class="size-4 animate-spin"></svg>
}
Sign in
</button>
</form>
<p class="mt-6 text-center text-sm text-muted">
New to Chatex?
<a
routerLink="/register"
[queryParams]="returnUrl() ? { returnUrl: returnUrl() } : {}"
class="font-medium text-brand-600 hover:underline dark:text-brand-400"
>Create an account</a
>
</p>
</app-auth-layout>
`,
})
export class LoginPage {
private readonly auth = inject(AuthService);
private readonly router = inject(Router);
readonly returnUrl = input<string>();
protected readonly busy = signal(false);
protected readonly error = signal<string | null>(null);
protected readonly form = inject(NonNullableFormBuilder).group({
login: ['', Validators.required],
password: ['', Validators.required],
});
protected invalid(name: 'login' | 'password'): boolean {
const control = this.form.controls[name];
return control.invalid && control.touched;
}
protected async submit(): Promise<void> {
if (this.form.invalid) {
this.form.markAllAsTouched();
return;
}
this.busy.set(true);
this.error.set(null);
try {
const { login, password } = this.form.getRawValue();
await this.auth.login({ login: login.trim(), password });
await this.router.navigateByUrl(safeReturnUrl(this.returnUrl()));
} catch (error) {
this.error.set(problemMessage(error));
} finally {
this.busy.set(false);
}
}
}
/** Only follow in-app paths, never another origin. */
export function safeReturnUrl(url: string | undefined): string {
return url && url.startsWith('/') && !url.startsWith('//') ? url : '/chats';
}inject(NonNullableFormBuilder).group({ … })будуєFormGroupіз двомаFormControl<string>. Ненулювальний означає, щоreset()повертає елемент керування до початкового значення'', а не доnull, тож тип значення лишаєтьсяstring.Validators.required– вбудований валідатор; формаinvalid, поки не проходить будь-який валідатор.[formGroup]="form"іformControlName="login"прив’язують форму HTML та її поля введення до моделі; ці директиви надаєReactiveFormsModuleвimports. Якщо його забути, збирання завершиться помилкоюNG8002: Can't bind to 'formGroup' since it isn't a known property of 'form'.(ngSubmit)="submit()"– це прив’язка події: круглі дужки слухають, квадратні прив’язують властивість.novalidateвимикає власні підказки перевірки браузера на користь наших.invalid(name)показує повідомлення поля лише після того, як користувач торкнувся його (один раз залишив) – а не доки він ще набирає перший символ.submit()позначає всі поля як торкнуті, коли форма недійсна, тож клацання «Sign in» з порожніми полями показує обидва повідомлення.busyіerror– сигнали; поки виконується запит, кнопка вимкнена й показує індикатор, а помилка зproblemMessageз’являється над формою («Wrong user name, email or password.»).returnUrl = input<string>()отримує параметр запиту?returnUrl=, який додавauthGuard, завдякиwithComponentInputBinding()з теми 16. Посилання на сторінку реєстрації передає його далі через[queryParams].safeReturnUrlпереходить лише за шляхами цього застосунку. URL із рядка запиту контролює зловмисник:?returnUrl=https://evil.exampleне повинен перетворювати сторінку входу на відкрите перенаправлення (open redirect). Шлях має починатися з/, але не з//, який браузери читають як інший вузол.
Крок 3. Реєстрація з помилками полів від сервера
Навіщо. Форма реєстрації повторює правила сервера (тема 8), щоб більшість помилок виявлялася до запиту: ім’я користувача з 3–32 літер, цифр і _, що починається з літери, дійсна електронна адреса, пароль щонайменше з 8 символів із цифрою. Деякі помилки можуть надійти лише від сервера – ім’я користувача або електронна адреса зайняті, – і вони мають з’явитися під потрібним полем, а не як загальне повідомлення.
Що зробити. Створіть сторінку:
angular-ts
import { ChangeDetectionStrategy, Component, inject, input, signal } from '@angular/core';
import { NonNullableFormBuilder, ReactiveFormsModule, Validators } from '@angular/forms';
import { Router, RouterLink } from '@angular/router';
import { fieldErrors, problemMessage, toProblem } from '../../core/api/problem';
import { AuthService } from '../../core/auth/auth.service';
import { ICONS } from '../../shared/ui/icons';
import { AuthLayout } from './auth-layout';
import { safeReturnUrl } from './login.page';
type Field = 'displayName' | 'userName' | 'email' | 'password';
/** Mirrors the server rules so most mistakes are caught before submitting. */
export const USER_NAME_PATTERN = /^[a-zA-Z][a-zA-Z0-9_]*$/;
export const PASSWORD_PATTERN = /\d/;
@Component({
selector: 'app-register-page',
imports: [ReactiveFormsModule, RouterLink, AuthLayout, ICONS],
changeDetection: ChangeDetectionStrategy.OnPush,
template: `
<app-auth-layout heading="Create your account" subheading="It takes less than a minute">
<form [formGroup]="form" (ngSubmit)="submit()" 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="displayName">Display name</label>
<input
id="displayName"
class="input"
formControlName="displayName"
autocomplete="name"
maxlength="64"
[class.input-invalid]="message('displayName')"
/>
@if (message('displayName'); as m) {
<p class="field-error">{{ m }}</p>
}
</div>
<div>
<label class="label" for="userName">User name</label>
<div class="relative">
<span class="pointer-events-none absolute top-1/2 left-3 -translate-y-1/2 text-muted"
>@</span
>
<input
id="userName"
class="input pl-7"
formControlName="userName"
autocomplete="username"
autocapitalize="none"
maxlength="32"
[class.input-invalid]="message('userName')"
/>
</div>
@if (message('userName'); as m) {
<p class="field-error">{{ m }}</p>
} @else {
<p class="mt-1 text-xs text-muted">
3–32 characters: letters, digits and _. Starts with a letter.
</p>
}
</div>
<div>
<label class="label" for="email">Email</label>
<input
id="email"
class="input"
type="email"
formControlName="email"
autocomplete="email"
[class.input-invalid]="message('email')"
/>
@if (message('email'); as m) {
<p class="field-error">{{ m }}</p>
}
</div>
<div>
<label class="label" for="password">Password</label>
<input
id="password"
class="input"
type="password"
formControlName="password"
autocomplete="new-password"
[class.input-invalid]="message('password')"
/>
@if (message('password'); as m) {
<p class="field-error">{{ m }}</p>
} @else {
<p class="mt-1 text-xs text-muted">At least 8 characters, including a digit.</p>
}
</div>
<button type="submit" class="btn-primary w-full" [disabled]="busy()">
@if (busy()) {
<svg lucideLoaderCircle class="size-4 animate-spin"></svg>
}
Create account
</button>
</form>
<p class="mt-6 text-center text-sm text-muted">
Already have an account?
<a
routerLink="/login"
[queryParams]="returnUrl() ? { returnUrl: returnUrl() } : {}"
class="font-medium text-brand-600 hover:underline dark:text-brand-400"
>Sign in</a
>
</p>
</app-auth-layout>
`,
})
export class RegisterPage {
private readonly auth = inject(AuthService);
private readonly router = inject(Router);
readonly returnUrl = input<string>();
protected readonly busy = signal(false);
protected readonly error = signal<string | null>(null);
private readonly serverErrors = signal<Partial<Record<Field, string>>>({});
protected readonly form = inject(NonNullableFormBuilder).group({
displayName: ['', [Validators.required, Validators.maxLength(64)]],
userName: [
'',
[
Validators.required,
Validators.minLength(3),
Validators.maxLength(32),
Validators.pattern(USER_NAME_PATTERN),
],
],
email: ['', [Validators.required, Validators.email, Validators.maxLength(256)]],
password: [
'',
[
Validators.required,
Validators.minLength(8),
Validators.maxLength(128),
Validators.pattern(PASSWORD_PATTERN),
],
],
});
constructor() {
// A server error for a field goes away as soon as the user edits that field.
for (const name of Object.keys(this.form.controls) as Field[]) {
this.form.controls[name].valueChanges.subscribe(() =>
this.serverErrors.update((e) => ({ ...e, [name]: undefined })),
);
}
}
protected message(name: Field): string | null {
const server = this.serverErrors()[name];
if (server) {
return server;
}
const control = this.form.controls[name];
if (!control.touched || control.valid) {
return null;
}
const e = control.errors ?? {};
if (e['required']) return 'This field is required.';
if (name === 'userName') {
if (e['minlength']) return 'At least 3 characters.';
if (e['pattern']) return 'Start with a letter; use only letters, digits and _.';
}
if (name === 'email') return 'Enter a valid email address.';
if (name === 'password') {
if (e['minlength']) return 'At least 8 characters.';
if (e['pattern']) return 'Include at least one digit.';
}
if (e['maxlength']) return 'Too long.';
return 'Invalid value.';
}
protected async submit(): Promise<void> {
if (this.form.invalid) {
this.form.markAllAsTouched();
return;
}
this.busy.set(true);
this.error.set(null);
try {
const value = this.form.getRawValue();
await this.auth.register({
displayName: value.displayName.trim(),
userName: value.userName.trim(),
email: value.email.trim(),
password: value.password,
});
await this.router.navigateByUrl(safeReturnUrl(this.returnUrl()));
} catch (error) {
const problem = toProblem(error);
if (problem.code === 'user_name_taken') {
this.serverErrors.set({ userName: problemMessage(error) });
} else if (problem.code === 'email_taken') {
this.serverErrors.set({ email: problemMessage(error) });
} else if (Object.keys(problem.errors).length) {
const fields: Partial<Record<Field, string>> = {};
for (const name of ['displayName', 'userName', 'email', 'password'] as Field[]) {
fields[name] = fieldErrors(error, name)[0];
}
this.serverErrors.set(fields);
} else {
this.error.set(problemMessage(error));
}
} finally {
this.busy.set(false);
}
}
}USER_NAME_PATTERNіPASSWORD_PATTERNекспортуються: сторінка налаштувань із теми 21 перевіряє новий пароль за тим самим правилом.message(name)повертає єдине повідомлення, яке слід показати під полем: спершу помилку сервера для цього поля, потім перший валідатор, що не пройшов, у розумному порядку.@if (message('userName'); as m)зберігає результат у змінній шаблону, тож він обчислюється один раз за відображення. Зверніть увагу наe['required']:noPropertyAccessFromIndexSignature(тема 15) вимагає дужкової нотації для ключів словника.serverErrorsвідображає імена полів на повідомлення сервера. Конструктор підписується наvalueChangesкожного елемента керування – Observable його значень – і очищає помилку сервера для поля, щойно користувач його змінює.submit()розбирає відповідь сервера.user_name_takenіemail_takenналежать кожен одному полю (зрозумілий текст відproblemMessage); інші помилки перевірки розподіляються за полями черезfieldErrors; усе інше стає загальною помилкою над формою.maxlengthна полях введення зупиняє набір на межі, тож валідаториmaxLengthспрацьовують лише для вставленого тексту.@у шаблоні – це символ@. Одинокий@починає блок керування потоком у шаблоні Angular, тому буквальний символ треба записувати як сутність HTML.
Перевірка
npm run build завершується успішно; сторінки стануть досяжними, коли з’являться маршрути (наступний розділ).