Angular UI 패턴
핵심 원칙
- 오래된 UI를 절대 보여주지 않음 - 실제 로딩 중일 때만 로딩 상태 표시
- 오류를 항상 표시 - 사용자는 무언가 실패했을 때 반드시 알아야 함
- 낙관적 업데이트 - UI를 즉각적으로 느끼게 만듦
- 점진적 공개 -
@defer를 사용하여 콘텐츠를 사용 가능할 때 표시 - 우아한 저하 - 부분적인 데이터가 데이터가 없는 것보다 나음
로딩 상태 패턴
황금률
표시할 데이터가 없을 때만 로딩 표시기를 보여주세요.
@Component({
template: `
@if (error()) {
<app-error-state [error]="error()" (retry)="load()" />
} @else if (loading() && !items().length) {
<app-skeleton-list />
} @else if (!items().length) {
<app-empty-state message="항목을 찾을 수 없습니다" />
} @else {
<app-item-list [items]="items()" />
}
`,
})
export class ItemListComponent {
private store = inject(ItemStore);
items = this.store.items;
loading = this.store.loading;
error = this.store.error;
}
로딩 상태 결정 트리
오류가 있습니까?
→ 예: 재시도 옵션이 있는 오류 상태 표시
→ 아니오: 계속
로딩 중이고 데이터가 없습니까?
→ 예: 로딩 표시기(스피너/스켈레톤) 표시
→ 아니오: 계속
데이터가 있습니까?
→ 예, 항목 있음: 데이터 표시
→ 예, 비어 있음: 빈 상태 표시
→ 아니오: 로딩 표시(폴백)
스켈레톤 vs 스피너
| 스켈레톤 사용 시기 | 스피너 사용 시기 |
|---|---|
| 알려진 콘텐츠 모양 | 알 수 없는 콘텐츠 모양 |
| 목록/카드 레이아웃 | 모달 액션 |
| 초기 페이지 로드 | 버튼 제출 |
| 콘텐츠 플레이스홀더 | 인라인 작업 |
제어 흐름 패턴
@if/@else를 사용한 조건부 렌더링
@if (user(); as user) {
<span>환영합니다, {{ user.name }}님</span>
} @else if (loading()) {
<app-spinner size="small" />
} @else {
<a routerLink="/login">로그인</a>
}
@for와 Track 사용
@for (item of items(); track item.id) {
<app-item-card [item]="item" (delete)="remove(item.id)" />
} @empty {
<app-empty-state
icon="inbox"
message="아직 항목이 없습니다"
actionLabel="항목 만들기"
(action)="create()"
/>
}
@defer를 사용한 점진적 로딩
<!-- 중요한 콘텐츠는 즉시 로드 -->
<app-header />
<app-hero-section />
<!-- 중요하지 않은 콘텐츠는 지연 -->
@defer (on viewport) {
<app-comments [postId]="postId()" />
} @placeholder {
<div class="h-32 bg-gray-100 animate-pulse"></div>
} @loading (minimum 200ms) {
<app-spinner />
} @error {
<app-error-state message="댓글을 불러오지 못했습니다" />
}
오류 처리 패턴
오류 처리 계층 구조
1. 인라인 오류(필드 수준) → 양식 유효성 검사 오류
2. 토스트 알림 → 복구 가능한 오류, 사용자가 재시도 가능
3. 오류 배너 → 페이지 수준 오류, 데이터가 부분적으로 사용 가능
4. 전체 오류 화면 → 복구 불가능, 사용자 작업 필요
오류 항상 표시
중요: 절대 오류를 조용히 삼키지 마세요.
// 올바름 - 오류가 항상 사용자에게 표시됨
@Component({...})
export class CreateItemComponent {
private store = inject(ItemStore);
private toast = inject(ToastService);
async create(data: CreateItemDto) {
try {
await this.store.create(data);
this.toast.success('항목이 성공적으로 생성되었습니다');
this.router.navigate(['/items']);
} catch (error) {
console.error('createItem 실패:', error);
this.toast.error('항목 생성에 실패했습니다. 다시 시도해 주세요.');
}
}
}
// 잘못됨 - 오류가 조용히 처리됨
async create(data: CreateItemDto) {
try {
await this.store.create(data);
} catch (error) {
console.error(error); // 사용자는 아무것도 볼 수 없음!
}
}
오류 상태 컴포넌트 패턴
@Component({
selector: "app-error-state",
standalone: true,
imports: [NgOptimizedImage],
template: `
<div class="error-state">
<img ngSrc="/assets/error-icon.svg" width="64" height="64" alt="" />
<h3>{{ title() }}</h3>
<p>{{ message() }}</p>
@if (retry.observed) {
<button (click)="retry.emit()" class="btn-primary">다시 시도</button>
}
</div>
`,
})
export class ErrorStateComponent {
title = input("문제가 발생했습니다");
message = input("예기치 않은 오류가 발생했습니다");
retry = output<void>();
}
버튼 상태 패턴
버튼 로딩 상태
<button
(click)="handleSubmit()"
[disabled]="isSubmitting() || !form.valid"
class="btn-primary"
>
@if (isSubmitting()) {
<app-spinner size="small" class="mr-2" />
저장 중... } @else { 변경 사항 저장 }
</button>
작업 중 비활성화
중요: 비동기 작업 중에는 항상 트리거를 비활성화하세요.
// 올바름 - 로딩 중 버튼 비활성화
@Component({
template: `
<button
[disabled]="saving()"
(click)="save()"
>
@if (saving()) {
<app-spinner size="sm" /> 저장 중...
} @else {
저장
}
</button>
`
})
export class SaveButtonComponent {
saving = signal(false);
async save() {
this.saving.set(true);
try {
await this.service.save();
} finally {
this.saving.set(false);
}
}
}
// 잘못됨 - 사용자가 여러 번 클릭 가능
<button (click)="save()">
{{ saving() ? '저장 중...' : '저장' }}
</button>
빈 상태
빈 상태 요구 사항
모든 목록/컬렉션에는 반드시 빈 상태가 있어야 합니다:
@for (item of items(); track item.id) {
<app-item-card [item]="item" />
} @empty {
<app-empty-state
icon="folder-open"
title="아직 항목이 없습니다"
description="시작하려면 첫 번째 항목을 만드세요"
actionLabel="항목 만들기"
(action)="openCreateDialog()"
/>
}
상황별 빈 상태
@Component({
selector: "app-empty-state",
template: `
<div class="empty-state">
<span class="icon" [class]="icon()"></span>
<h3>{{ title() }}</h3>
<p>{{ description() }}</p>
@if (actionLabel()) {
<button (click)="action.emit()" class="btn-primary">
{{ actionLabel() }}
</button>
}
</div>
`,
})
export class EmptyStateComponent {
icon = input("inbox");
title = input.required<string>();
description = input("");
actionLabel = input<string | null>(null);
action = output<void>();
}
양식 패턴
로딩 및 유효성 검사가 포함된 양식
@Component({
template: `
<form [formGroup]="form" (ngSubmit)="onSubmit()">
<div class="form-field">
<label for="name">이름</label>
<input
id="name"
formControlName="name"
[class.error]="isFieldInvalid('name')"
/>
@if (isFieldInvalid("name")) {
<span class="error-text">
{{ getFieldError("name") }}
</span>
}
</div>
<div class="form-field">
<label for="email">이메일</label>
<input id="email" type="email" formControlName="email" />
@if (isFieldInvalid("email")) {
<span class="error-text">
{{ getFieldError("email") }}
</span>
}
</div>
<button type="submit" [disabled]="form.invalid || submitting()">
@if (submitting()) {
<app-spinner size="sm" /> 제출 중...
} @else {
제출
}
</button>
</form>
`,
})
export class UserFormComponent {
private fb = inject(FormBuilder);
submitting = signal(false);
form = this.fb.group({
name: ["", [Validators.required, Validators.minLength(2)]],
email: ["", [Validators.required, Validators.email]],
});
isFieldInvalid(field: string): boolean {
const control = this.form.get(field);
return control ? control.invalid && control.touched : false;
}
getFieldError(field: string): string {
const control = this.form.get(field);
if (control?.hasError("required")) return "이 필드는 필수입니다";
if (control?.hasError("email")) return "유효하지 않은 이메일 형식입니다";
if (control?.hasError("minlength")) return "너무 짧습니다";
return "";
}
async onSubmit() {
if (this.form.invalid) return;
this.submitting.set(true);
try {
await this.service.submit(this.form.value);
this.toast.success("성공적으로 제출되었습니다");
} catch {
this.toast.error("제출에 실패했습니다");
} finally {
this.submitting.set(false);
}
}
}
대화상자/모달 패턴
확인 대화상자
// dialog.service.ts
@Injectable({ providedIn: 'root' })
export class DialogService {
private dialog = inject(Dialog); // CDK Dialog 또는 사용자 정의
async confirm(options: {
title: string;
message: string;
confirmText?: string;
cancelText?: string;
}): Promise<boolean> {
const dialogRef = this.dialog.open(ConfirmDialogComponent, {
data: options,
});
return await firstValueFrom(dialogRef.closed) ?? false;
}
}
// 사용법
async deleteItem(item: Item) {
const confirmed = await this.dialog.confirm({
title: '항목 삭제',
message: `"${item.name}"을(를) 삭제하시겠습니까?`,
confirmText: '삭제',
});
if (confirmed) {
await this.store.delete(item.id);
}
}
안티 패턴
로딩 상태
// 잘못됨 - 데이터가 있을 때 스피너 표시 (재조회 시 깜빡임 발생)
@if (loading()) {
<app-spinner />
}
// 올바름 - 데이터 없을 때만 로딩 표시
@if (loading() && !items().length) {
<app-spinner />
}
오류 처리
// 잘못됨 - 오류가 삼켜짐
try {
await this.service.save();
} catch (e) {
console.log(e); // 사용자는 알 수 없음!
}
// 올바름 - 오류가 표시됨
try {
await this.service.save();
} catch (e) {
console.error("저장 실패:", e);
this.toast.error("저장에 실패했습니다. 다시 시도해 주세요.");
}
버튼 상태
<!-- 잘못됨 - 제출 중 버튼이 비활성화되지 않음 -->
<button (click)="submit()">제출</button>
<!-- 올바름 - 비활성화되고 로딩 표시 -->
<button (click)="submit()" [disabled]="loading()">
@if (loading()) {
<app-spinner size="sm" />
} 제출
</button>
UI 상태 체크리스트
UI 컴포넌트를 완료하기 전에 확인하세요:
UI 상태
- 오류 상태가 처리되고 사용자에게 표시됨
- 로딩 상태는 데이터가 없을 때만 표시됨
- 컬렉션에 빈 상태 제공됨 (
@empty블록) - 비동기 작업 중 버튼 비활성화됨
- 버튼에 필요 시 로딩 표시기 표시됨
데이터 및 변경
- 모든 비동기 작업에 오류 처리 있음
- 모든 사용자 작업에 피드백 있음 (토스트/시각적)
- 낙관적 업데이트 실패 시 롤백 처리
접근성
- 로딩 상태가 스크린 리더에 전달됨
- 오류 메시지가 양식 필드에 연결됨
- 상태 변경 후 포커스 관리
다른 스킬과의 통합
- angular-state-management: 상태에 Signal 저장소 사용
- angular: 최신 패턴 적용 (Signals, @defer)
- testing-patterns: 모든 UI 상태 테스트