---
{"id":"notification","title":"알림·폼 피드백","category":"컴포넌트","order":42,"summary":"작업 결과·복구 안내·상태 변경을 전달의 사용·상태·접근성 계약.","status":"문서 기준 · UI 미검증","references":["components/notification/usage"]}
---

# 알림·폼 피드백

## 목적과 사용

작업 결과·복구 안내·상태 변경을 전달에 사용합니다. 모든 배경 요청에 팝업을 띄우거나 중요한 오류를 일회성 toast로만 표시하지 않습니다.

## 구성과 변형

심각도, 제목, 설명, 선택적 다음 행동/닫기. 변형의 외형은 각 제품의 기존 [토큰](tokens.md)을 사용합니다. Carbon의 크기·색·모서리·아이콘을 가져오지 않습니다.

## 동작 규칙

- NTF-01 MUST: 오류·경고·정보·성공의 의미를 구분합니다.
- NTF-02 MUST: 같은 사건을 전체 화면·inline·toast로 중복 표시하지 않습니다.
- NTF-03 MUST: 수정이 필요한 오류는 해당 위치에서 지속적으로 확인 가능합니다.
- NTF-04 SHOULD: 사용자가 볼 필요가 있는 정보만 적절한 강도로 알립니다.

## 접근성

긴급 오류 alert, 일반 결과 status를 검토하고 중복 live region을 피합니다. 자동 소멸에 필수 행동을 넣지 않습니다. 공통 [접근성 기준](accessibility.md)도 함께 적용합니다.

## 콘텐츠 예시

좋음: ‘키 저장 실패 — 형식을 확인하세요’ / 피함: 실패를 중립 도움말로 숨김.

## 우리 구현과 연결

VPS WickedFormNotice는 error→alert, 나머지→status를 실제 코드로 확인했습니다. Panel은 MessageBox/ScreenBlock을 소유합니다.

제품별 소유 경로는 [WICKEDVPS](product-vps.md), [Panel](product-panel.md), [Blesta](product-blesta.md)와 [소스 근거](source-evidence.md)를 확인합니다. 코드 존재와 모든 사용처의 준수는 다르며, 별도 표시가 없는 제품별 준수 상태는 미검증입니다.

## 코드 계약 예시

다음은 의미 구조 설명용이며 운영 API에 연결된 완성 구현이 아닙니다.

```html
<div role="status">복사했습니다.</div>
```

## 상태와 검증

오류 반복·대상 화면 밖·닫기 후 재발·화면 낭독기 중복·지속성을 확인합니다.

일반·hover·focus·실행 중·실패·성공·disabled·read-only 중 해당하는 상태를 기록합니다. 해당하지 않는 상태를 임의로 만들지 말고 이유를 남깁니다. [검증 체크리스트](testing.md)에 증거를 연결합니다.