Skip to main content
Skip table of contents

Web - SpeechBubble (Added in 2.2)

Added in 2.2

Definition

정의

SpeechBubble

최적화 대상

Desktop

Mobile

기획 배포

완료

디자인 가이드 배포

완료

개발 코드 배포

완료

Principle

말풍선이긴 하지만 대화 UI가 아니라, 다른 컴포넌트나 요소를 설명해주는 보조적 용도로 사용합니다.
(채팅에서 사용하는 말풍선은 Web - ChatBubbleListItem (Added in 1.4) 을 확인해 주세요.)

SpeechBubble은 컴포넌트가 위치한 가로축의 영역을 모두 차지하며, 액션 없이 사용합니다.

image-20250904-020243.png

기획 가이드

 

공통

Do

  • SpeechBubble은 컴포넌트가 위치한 가로축 공간 전체를 차지합니다.

  • pointingPosition은 기본적으로 제공되는 값을 따르며, 상황에 따라 조정이 필요할 경우 Custom으로 입력하여 작성합니다.

Don’t

  • SpeechBubble이 위치한 가로축에 다른 요소가 중첩되어 사용되지 않도록 합니다.

  • backgroundColor에서 투명 배경은 사용하지 않습니다.


구성

* 말풍선 안에는 Text 혹은 Component의 조합이 들어갈 수 있습니다.

image-20250909-092946.png

Spec

Guide

image-20250909-094220.png
image-20250909-094211.png


Properties

text*

말풍선에 표시할 텍스트 값입니다.

기획 지시사항

  • 기획서 상 작성 방법 : 텍스트만 기술

Type

number | string | object | Array<string | object> | undefined | null

Default

-

size

크기를 결정합니다. 단순히 요소의 width, height 뿐만 아니라 텍스트 크기도 포함됩니다.

기획 지시사항

  • 기획서 상 작성 방법 : Enum Values 중 하나를 사용함

Type

enum

Default

'small'

Enum Values Description

'small'

caption2Regular

'medium'

caption1Regular 

fontWeight

말풍선에 표시되는 텍스트의 굵기를 설정합니다.

기획 지시사항

  • 기획서 상 작성 방법 : Enum Values 중 하나를 사용함

Type

enum

Default

'bold'

Enum Values Description

'regualr'

'bold'

textColorOverride

텍스트 컬러의 키값을 직접 입력할 수 있습니다. (ui_로 시작하는 키값 부여)
color에 키 값을 넣으면 colorTheme의 값은 무시됩니다.

기획 지시사항

  • 기획서 상 작성 방법 : Enum Values 중 하나를 사용함

Type

enum

Default

-

Enum Values Description

정해져 있는 컬러 값 중 하나를 부여합니다. (ui_xxx의 형식입니다.)

textColorTheme

텍스트 컬러의 프리셋 테마입니다.

기획 지시사항

  • 기획서 상 작성 방법 : Enum Values 중 하나를 사용함

Type

enum

Default

'sysTextWhite'

Enum Values Description

'sysTextPrimary'

 

'sysTextSecondary'

 

'sysTextTertiary'

 

'sysTextWhite'

 

'sysTextBlack'

'sysTextError'

 

'sysTextWarning'

'sysTextBrandPrimary'

 

'sysTextBrandSeconVariant'

 

'usrTextBrandPrimary'

 

'usrTextBrandSeconVariant'

 

'usrTextBrandOnPrimary'

 

bubbleAlign

말풍선이 차지하는 가로축에서 어떻게 정렬할지를 정합니다.

기획 지시사항

  • 기획서 상 작성 방법 : Enum Values 중 하나를 사용함

Type

enum

Default

left

Enum Values Description

'right'

가로축의 오른쪽에 정렬합니다.

'middle'

가로축의 가운데에 정렬합니다.

'left'

가로축의 왼쪽에 정렬합니다.

backgroundColorKey

말풍선의 배경 색상을 정합니다.

기획 지시사항

  • 기획서 상 작성 방법 : Enum Values 중 하나를 사용함

  • 주의 투명으로 표시되는 키 값은 사용하지 않습니다.

Type

enum

Default

-

Enum Values Description

정해져 있는 컬러 값 중 하나를 부여합니다. (ui_xxx의 형식입니다.)

pointingPosition

말풍선의 포인터 위치를 정합니다.

기획 지시사항

  • 기획서 상 작성 방법 : Enum Values 중 하나를 사용함

Type

enum

Default

start_bottom

Enum Values Description

'start_top'

'start_bottom'

'center_top'

'center_bottom'

'end_top'

'end_bottom'

shapeType

말풍선의 모양을 정합니다.

기획 지시사항

  • 기획서 상 작성 방법 : Enum Values 중 하나를 사용함

Type

enum

Default

'round'

Enum Values Description

'round'

둥근 모서리를 가진 사각형

'rectangle'

각진 모서리를 가진 사각형

radius

말풍선의 테두리 둥글기를 정합니다.
*shapeType이 round인 경우에만 사용합니다.

기획 지시사항

  • 기획서 상 작성 방법 : 텍스트만 기술

Type

number

Default

8

Enum Values Description

'8'

'12'

'16'

borderMode

말풍선의 테두리 사용 여부를 정합니다.

기획 지시사항

  • 기획서 상 작성 방법 : Enum Values 중 하나를 사용함

Type

enum

Default

'none'

Enum Values Description

'none'

테두리를 사용하지 않습니다.

'use'

테두리를 사용합니다.

boderColorKey

말풍선의 테두리 색상을 정합니다.
*boderMode use일 경우에만 적용할 수 있습니다.

기획 지시사항

  • 기획서 상 작성 방법 : Enum Values 중 하나를 사용함

Type

enum

Default

'ui_cpnt_contextmenu_border'

Enum Values Description

정해져 있는 컬러 값 중 하나를 부여합니다. (ui_xxx의 형식입니다.)

borderMode

말풍선의 테두리 사용 여부를 정합니다.

기획 지시사항

  • 기획서 상 작성 방법 : Enum Values 중 하나를 사용함

Type

enum

Default

'none'

Enum Values Description

'none'

테두리를 사용하지 않습니다.

'use'

테두리를 사용합니다.

paddingTop

상단의 padding 간격 값을 결정합니다.

기획 지시사항

  • 기획서 상 작성 방법 : Enum Values 중 하나를 사용함

Type

enum

Default

'spacing_a'

Enum Values Description

'none'

 

'spacing_a'

 

'spacing_b'

 

'spacing_c'

 

'spacing_d'

 

'spacing_e'

 

'spacing_f'

 

'spacing_g'

 

paddingRight

우측의 padding 간격 값을 결정합니다.

기획 지시사항

  • 기획서 상 작성 방법 : Enum Values 중 하나를 사용함

Type

enum

Default

'spacing_c'

Enum Values Description

'none'

 

'spacing_a'

 

'spacing_b'

 

'spacing_c'

 

'spacing_d'

 

'spacing_e'

 

'spacing_f'

 

'spacing_g'

 

paddingBottom

하단의 padding 간격 값을 결정합니다.

기획 지시사항

  • 기획서 상 작성 방법 : Enum Values 중 하나를 사용함

Type

enum

Default

'spacing_a'

Enum Values Description

'none'

 

'spacing_a'

 

'spacing_b'

 

'spacing_c'

 

'spacing_d'

 

'spacing_e'

 

'spacing_f'

 

'spacing_g'

 

paddingLeft

좌측의 padding 간격 값을 결정합니다.

기획 지시사항

  • 기획서 상 작성 방법 : Enum Values 중 하나를 사용함

Type

enum

Default

'spacing_c'

Enum Values Description

'none'

 

'spacing_a'

 

'spacing_b'

 

'spacing_c'

 

'spacing_d'

 

'spacing_e'

 

'spacing_f'

 

'spacing_g'

 


문서 작성 정보

소유자 / 관리자

김혜진 / 박윤규

변경 이력

  • 2025/09/05 : 문서 최초 작성 - 곽은선

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.