Help Bubble

Primitive

특정 요소를 가리키며 간결하고 상황에 맞는 정보를 제공하는 컴포넌트입니다.

구조도

  1. Trigger
  2. Anchor
  3. Backdrop
  4. Arrow
  5. Content
  6. Message
  7. Close Trigger

컴포넌트 미리보기

옵션

Placement

Help Bubble은 Trigger를 기준으로 위치를 지정합니다. 다양한 Placement 옵션을 적절히 배치하여, 유저가 최대한 편리하게 정보를 이해하고 접근할 수 있도록 도와줍니다.

Offset

Offset은 Help Bubble과 Trigger 사이의 거리 값입니다. 기본값은 8입니다.

Modal

Modal 옵션은 유저의 화면을 일시적으로 멈춘 뒤 전달해야 하는 중요한 정보인 경우에 사용합니다. 다른 요소와 상호작용 할 수 없음을 Backdrop을 통해 전달합니다.

Close Trigger

Help Bubble은 Close trigger를 가질 수 있습니다. 유저가 Help Bubble의 내용을 모두 읽었거나, 더 이상 필요하지 않을 때 Close trigger를 통해 닫을 수 있습니다.

Close On Interact Outside

Help Bubble 외부를 클릭하거나 터치, 또는 Tab키를 통해 다른 요소에 Focus 했을 때 Help Bubble을 닫을지 여부를 결정할 수 있습니다.

옵션 테이블

속성기본값
placement"top", "top-start", "top-end", "right", "right-start", "right-end", "bottom", "bottom-start", "bottom-end", "left", "left-start", "left-end""bottom"
offsetnumber8pt
cross offsetnumber0pt
is modalfalse, truegray
default openfalse, truefalse
show close triggerfalse, truefalse
close on interact outsidefalse, truetrue

상호작용

Click, Touch는 Close Button 영역에만 작동합니다.

키보드

Dismiss

Esc키를 통해 Help Bubble을 닫을 수 있습니다.

가이드라인

Trigger

Trigger 사용을 통해 유저가 Help Bubble에 접근할 수 있도록 유도할 수 있습니다. 주로 직관적인 Text Button이나 Icon을 사용합니다.

간결한 문구

문구는 최대한 간결하게 작성하고, 불필요한 부가정보는 최소화합니다.

Close Button

Help Bubble은 화면에 Overlay되는 컴포넌트로, 내용을 가려 사용자 경험을 방해할 수 있습니다. 유저가 Help Bubble의 내용을 확인한 후 닫을 수 있도록 Close Button을 활용합니다.

개발 현황