Get startedFoundationsComponentsPatternsRules

Inline Message

인라인 메시지는 필요한 자리에서 아이콘과 짧은 문구로 상황을 알리고, 누르면 자세한 내용을 보여줘요.

설치

pnpm dlx shadcn@latest add https://rebar.conmarket-landing.workers.dev/r/steel/inline-message.json

Examples

Title · Secondary text

title 은 굵게 먼저 보이고, secondaryText 는 흐린 색으로 뒤에 붙어 한 줄로 잘려요. 둘 다 없으면 아이콘만 보이니 iconLabel 을 꼭 지정해요.

Placement

placement 로 팝업이 열리는 위치를 정해요. 기본값은 bottom-start 이고, 공간이 부족하면 반대쪽으로 자동으로 옮겨져요. 팝업은 Popup 과 같이 놓인 방향에서 8px 미끄러지며 나타나요.

Appearance

아이콘 모양과 색이 바뀌어요. 기본값은 connectivity 예요.

Appearance아이콘 색용도
warningcolor.icon.warning큰 변경 전에 알리거나 인증 문제를 알려요.
errorcolor.icon.danger작업 실패나 연결 문제
confirmationcolor.icon.success작업이 끝났음을 확인
infocolor.icon.discovery행동이 필요 없는 추가 정보
connectivitycolor.icon.brand로그인해야 자세히 볼 수 있을 때. warning·error 가 맞지 않을 때만 써요.

Spacing

spacing 은 아이콘 영역 크기예요. spacious 는 24px, compact 는 16px 이에요.

Usage guidelines

인라인 메시지는 경고·오류·완료·업데이트 같은 맥락 정보를 사용자가 필요한 바로 그 자리에 보여줘요. 아이콘, 제목, 보조 문구 중 아무거나 누르면 팝업이 열리고 더 자세한 설명과 관련 링크를 보여줘요.

  • 아이콘: 상태를 나타내요. 색과 모양으로 종류와 긴급도를 알 수 있어요.
  • 제목(선택): 짧고 굵게 써요. 되도록 넣어요.
  • 본문: 팝업 안의 일반 텍스트. 다섯 줄을 넘기지 않아요.
Do· 제목과 함께
아이콘만 두면 놓치기 쉬워요. 짧은 제목을 함께 보여줘요.
Don't· 지난 일에 경고
이미 일어난 일에는 warning 대신 error 를 써요.
  • 경고: 행동하기 전에, 놀라게 하지 않으면서 결과를 설명하고 가능한 대안을 알려줘요.
  • 오류: 원인을 구체적으로 밝히고 다음 단계를 안내해요. 기술 용어나 사용자를 탓하는 표현은 피해요.
  • 완료: 결과를 확인시키고 물러나요. 무언가를 만들었다면 바로 볼 수 있는 링크를 줘요.
  • 정보: 도움이 되는 내용을 행동 요구 없이 전달하고, 빨리 하던 일로 돌아가게 해요.
  • 이벤트 직후 알림은 Flag, 서비스 전체 문제는 Banner 를 써요.

Accessibility

  • 트리거는 버튼이라 Tab 으로 이동하고 Enter/Space 로 팝업을 열고 닫아요. Esc 를 누르거나 바깥을 누르면 닫혀요.
  • 팝업은 role="dialog" 이고 트리거 버튼을 이름으로 가져요. 열림 상태는 aria-expanded 로 전달돼요.
  • 제목이 없거나 아이콘이 의미를 더할 때는 iconLabel 로 접근성 이름을 지정해요.
  • 본문이 너무 길면 잘려서 읽기 어려워요. 다섯 줄 안으로 써요.

Props

Prop

Type

On this page