Alert

저장 결과나 주의 사항처럼 관련 콘텐츠 옆에 계속 보여야 하는 메시지에 사용합니다.

미리보기

정보·성공·오류 안내

Registry 업데이트, 동기화 완료, 토큰 누락을 각각의 아이콘과 설명으로 비교합니다.

설치

Registry를 처음 사용한다면 기본 설정과 공통 스타일 설치 을 먼저 완료하세요.

npx shadcn@latest add @neumorphism-ui/alert

공통 base를 한 번 설치한 뒤 CLI로 필요한 컴포넌트와 의존성을 추가합니다.

Registry JSON

사용법

Alert 안에 AlertTitle과 AlertDescription을 조합하세요. 메시지 의미에 맞는 variant를 고르고 색상과 함께 텍스트로도 결과를 설명합니다.

import { Alert, AlertDescription, AlertTitle } from "@/components/ui/alert";

export default function Example() {
  return (
    <Alert variant="success">
      <AlertTitle>Changes saved</AlertTitle>
      <AlertDescription>Your workspace is up to date.</AlertDescription>
    </Alert>
  );
}

API 레퍼런스

아이콘, 제목, 설명을 정렬하는 조합형 Alert입니다. default, success, destructive 변형이 있으며 모든 변형이 색상 외에 테두리와 텍스트 대비를 함께 사용합니다.

컴포넌트속성타입기본값설명
Alertvariant"default" | "success" | "destructive""default"메시지의 의미와 시각적 상태를 선택합니다.
AlertchildrenReact.ReactNode—아이콘, AlertTitle, AlertDescription을 배치합니다.
AlertclassNamestring—기본 표면 스타일을 확장합니다.

접근성

  • 01

    Alert는 role=alert를 사용하므로 동적으로 나타나는 중요한 메시지에 적합합니다.

  • 02

    페이지 로드 때부터 보이는 일반 안내에는 role=alert의 즉시 읽기가 불필요할 수 있으므로 role을 덮어쓰거나 다른 컨테이너를 사용합니다.

  • 03

    장식 아이콘에는 aria-hidden=true를 지정하고 의미는 제목과 설명 텍스트로도 전달합니다.