Skip to main content
Skip table of contents

[작업중] Web - PriceTextLabel

PriceTextLabel은 Web - TextLabel 을 기반으로,
제품 내에서 ‘가격’이 표시되는 형태를 통일하기 위해 사용합니다.

Definition

정의

PriceTextLabel

최적화 대상

Desktop

Mobile

기획 배포

예정

디자인 가이드 배포

예정

개발 코드 배포

예정

Principle

제품 내에서 가격을 표시할 때 사용하는 PriceTextLabel 입니다.
다른 스트링이 포함되어 있지 않고, 가격만으로 표시될 경우, 해당 컴포넌트를 사용합니다.

  • 예) 10,000 KRW

만약 다른 스트링과 조합하여 사용할 경우, 해당 컴포넌트를 사용할 수 없습니다.

  • 이 경우 CoreModule이 가격과 통화가 표시되는 영역의 포맷을 지원할 수 있기 때문에, CoreModule 적용이 필요합니다.

  • 예) ‘지금부터 10,000 KRW’
    => TextLabel 컴포넌트를 사용하고, ‘10,000 KRW'는 CoreModule 적용

상품 가격 전역 규칙에 따라, 채널에서 가격이 표시될 경우 사용자 친화적으로 사용할 수 있습니다.

https://publ.atlassian.net/wiki/x/SAAK4 을 참고해 주세요.

styleTheme 별 용법

styleTheme

용법 (Price 용례에 따라 내용이 수정될 예정)

displayBold

wizardPageTitleBold

headingBold

leadParaBold

leadParaRegular

subTitleBold

subTitleRegular

body1Bold

*컴포넌트 수준에서 사용됨 (버튼)

body1Regular

body2Bold

body2Regular

콘텐츠의 본문에 주로 사용합니다.

caption1Bold

*컴포넌트 수준에서 사용됨 (priceTextField)

caption1Regular

*컴포넌트 수준에서 사용됨 (priceTextField)

colorTheme 별 용법

colorTheme

용법

sysTextPrimary

시스템 컬러이며, 가장 명도가 높습니다.

가격 표시에 주로 사용합니다.

ui_cpnt_textlabel_sys_primary

sysTextSecondary

시스템 컬러이며, 중간 명도를 갖습니다.

가격을 조회하거나 부가 정보로서 제공할 때 사용합니다.

ui_cpnt_textlabel_sys_secondary

sysTextTertiary

시스템 컬러이며, 가장 명도가 낮습니다.

중요하지 않은 정보나, 비활성화 일 때 사용합니다.

ui_cpnt_textlabel_sys_tertiary

sysTextWhite

시스템 컬러이며, 배경이 존재하여 흰색 텍스트를 쓸 때 사용합니다.

ui_cpnt_textlabel_sys_white

sysTextBlack

시스템 컬러이며, 배경이 존재하여 검정색 텍스트를 쓸 때 사용합니다.

ui_cpnt_textlabel_sys_black

sysTextError

시스템 컬러이며, 오류 상황일 때 사용합니다.

ui_cpnt_textlabel_sys_error

sysTextWarning

시스템 컬러이며, 경고 상황일 때 사용합니다.

ui_cpnt_textlabel_sys_warning

‌‌


Spec

tooltip 사용 시

  • 아이콘에서 4px을 두고 사방에 놓일 수 있습니다.

  • 아이콘 hover 시 문구가 뜨며, 영역을 벗어날 경우 시간차(대략 1초)를 두고 사라집니다.

Size, Property

구성

내용

tooltip base

  • radius : 4px

  • max-width : 240px

tooltip icon

Web - Icon 참고

  • size : 16

  • fillType : fill

  • iconName : ic_question

tooltip text

https://publ.atlassian.net/wiki/pages/resumedraft.action?draftId=2801192579 참고

  • styleTheme : caption2Regular

  • singleLineMode : use

requirement icon

Web - Icon 참고

  • size : 16

  • fillType : line

  • iconName : ic_requirement

bulletPoint

해당 텍스트와 같은 사이즈로 가운뎃점(글리프) 적용

Color 구성

Color Key

요소들의 컬러 변화로 상태들을 표현합니다.

Tooltip

iconColor

baseColor

textColor

Icon

  • colorKey : ui_cpnt_icon_sys_grey_03

ui_cpnt_button_tooltip_base

https://publ.atlassian.net/wiki/pages/resumedraft.action?draftId=3796008961&draftShareId=dec3d4d1-9346-439a-9a75-c3d47700f785 참고

  • colorOverride : ui_cpnt_textlabel_button_tooltip

Requirement

iconColor

Icon

  • colorKey : ui_cpnt_icon_sys_error_01


Properties

price*

표시할 텍스트 값입니다.

기획 지시사항

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

Type

object

Default

{ amount: number | string; currency: CurrencyCode; }

CurrencyCode = { KRW = 'KRW', USD = 'USD'}

tooltipText

tooltip은 단순 정보 전달의 기능만 할 수 있으며, 액션이나 링크를 넣을 수 없습니다. (추가 정보를 보여주는 단순 텍스트)
주로 해당 금액의 정보를 보여줄 때 사용합니다.

hover 시 표시할 텍스트 값입니다.

부여하지 않으면 tooltip기능이 활성화 되지 않습니다.

*해당 기능은 Desktop에서만 사용할 수 있습니다.

기획 지시사항

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

Type

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

Default

-

tooltipPosition

툴팁의 위치를 결정합니다.

*해당 기능은 Desktop에서만 사용할 수 있습니다.

기획 지시사항

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

Type

enum

Default

'right_bottom'

Enum Values Description

'left_top'

'?' 기준 왼쪽 상단에 위치합니다.

'left_bottom'

'?' 기준 왼쪽 하단에 위치합니다.

'right_top'

'?' 기준 오른쪽 상단에 위치합니다.

'right_bottom'

'?' 기준 오른쪽 하단에 위치합니다.

tooltipIconColorKey

툴팁의 아이콘 컬러 키값을 직접 입력할 수 있습니다. (ui_로 시작하는 키값 부여)

*해당 기능은 Desktop에서만 사용할 수 있습니다.

기획 지시사항

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

Type

enum

Default

'ui_cpnt_icon_sys_grey_03'

Enum Values Description

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

textAlign

텍스트 정렬 위치를 결정합니다.

*left Enum 사용을 지양하며, 예외적으로 사용이 필요한 경우 반드시 상급자의 검수 후 사용해 주세요.

기획 지시사항

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

Type

enum

Default

'right'

Enum Values Description

'left'

'right'

styleTheme

텍스트 스타일의 프리셋 테마입니다.

기획 지시사항

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

Type

enum

Default

'body2Regular'

Enum Values Description

'displayBold'

'wizardPageTitleBold'

'headingBold'

'leadParaBold'

'leadParaRegular'

'subTitleBold'

'subTitleRegular'

'body1Bold'

'body1Regular'

'body2Bold'

'body2Regular'

'caption1Bold'

'caption1Regular'

'capion2Bold'

'caption2Regular'

'form1Regular'

'form1Bold'

'form2Regular'

'form2Bold'

'blog1Regular'

colorOverride

텍스트 컬러의 키값을 직접 입력할 수 있습니다. (ui_로 시작하는 키값 부여)

color에 키값을 넣으면 colorTheme의 값은 무시됩니다.

기획 지시사항

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

Type

enum

Default

-

Enum Values Description

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

colorTheme

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

기획 지시사항

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

Type

enum

Default

'sysTextPrimary'

Enum Values Description

'sysTextPrimary'

'sysTextSecondary'

'sysTextTertiary'

'sysTextWhite'

'sysTextBlack'

'sysTextError'

'sysTextWarning'

'sysTextBrandPrimary'

'sysTextBrandSeconVariant'

'usrTextBrandPrimary'

'usrTextBrandSeconVariant'

'usrTextBrandOnPrimary'

singleLineMode

텍스트의 행간을 결정합니다.

기획 지시사항

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

Type

enum

Default

'none'

Enum Values Description

'none'

텍스트 사용 규칙 참조

*텍스트 스타일(사이즈)에 기본적으로 부여된 행간을 사용합니다.

'use'

텍스트 사용 규칙 참조

*텍스트가 1줄로만 사용할 시 부여합니다.

customFontSize

직접 지정한 텍스트의 사이즈를 결정합니다.
(vw와 같은 단위도 같이 사용 가능)

기획 지시사항

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

Type

string

Default

-

customFontWeight

직접 지정한 텍스트의 굵기를 결정합니다.

기획 지시사항

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

Type

enum

Default

-

Enum Values Description

'bold'

텍스트 사용 규칙의 ‘bold’를 따릅니다.

'regular'

텍스트 사용 규칙의 ‘regular’를 따릅니다.

textDecorationType

텍스트의 서식을 결정합니다.

기획 지시사항

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

Type

enum

Default

'none'

Enum Values Description

'none'

사용하지 않습니다.

'line_through'

취소선

letterSpacing

직접 텍스트의 사이 간격을 결정합니다.
(단위도 함께 적어주어야 합니다. vw와 같은 단위도 같이 사용 가능)

*반드시 디자인 검수 후에 사용 가능합니다.

기획 지시사항

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

Type

string

Default

-

useFriendlyName

통화 표시를 문구로 변경합니다.

*USER 단에서 PriceTextLabel을 사용할 경우 반드시 use로 prop을 사용해야 합니다(상품 가격 전역 규칙 참고).

기획 지시사항

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

Type

'use' | 'none'

Default

'none'

useMinus

마이너스 표시 여부를 변경합니다.

기획 지시사항

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

Type

'use' | 'none'

Default

'none'

currencyPosition

통화 기호 표시 위치를 변경합니다.

기획 지시사항

  • 기획서 상 작성 방법 : 기획자가 직접 prop을 기술하지 않음

Type

'suffix' | 'prefix'

Default

'suffix'


문서 작성 정보

소유자 / 관리자

곽은선, 김혜진

변경 이력

  • 2025/06/20 : 최초 문서 작성 - 곽은선

JavaScript errors detected

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

If this problem persists, please contact our support.