Skip to main content
Skip table of contents

Web - Chip

Definition

정의

Chip

최적화 대상

Desktop

Mobile

기획 배포

완료

디자인 가이드 배포

완료

개발 코드 배포

완료

Principle

Chip을 통해 콘텐츠를 쉽게 정렬 할 수 있고, 정보를 필터링 할 수 있습니다. 또한 단순 정보를 보여주기 위한 용도로도 사용할 수 있습니다.
필터링의 역할을 할 때에는 여러 개가 나열되어 그 중 하나를 선택하여 필터링 할 수 있습니다.


Spec

Guide

Size

style은 하단 property, value에서 자세한 설명을 확인할 수 있습니다.

사용하는 style

Height

text

left icon

right icon

category_choice

40px

(medium)

Web - TextLabel 참고

  • styleTheme : caption1Regular

  • singleLineMode : use

  • size : 16

  • fillType : line

  • iconName : ic_filter

  • size : 12 (터치 영역 24x32)

  • fillType : line

  • iconName : ic_xmark

filter_single,

filter_multi

32px

(small)

Web - TextLabel 참고

  • styleTheme : caption1Regular

  • singleLineMode : use

  • size : 16

N/A

removable

32px

(small)

Web - TextLabel 참고

  • styleTheme : caption1Regular

  • singleLineMode : use

N/A

  • size : 12 (터치 영역 24x32)

  • fillType : line

  • iconName : ic_xmark

label, time

20px

Web - TextLabel 참고

  • styleTheme : caption2Bold

  • singleLineMode : use

N/A

N/A

information

24px

(xsmall)

Web - TextLabel 참고

  • styleTheme : caption2Regular

  • singleLineMode : use

N/A

N/A

우측 칩을 지울 수 있는 제거 아이콘이 있을 경우 터치 영역은 24x32를 가지고 가며,
제거 터치 영역 제외 앞 텍스트 부분이 따로 터치 영역을 가지고 있을 수 있습니다.(category_choice의 active 상태일 때)

Color 구성

Color Key

style에 따라 inactive, active 상태가 있는 것과 default 상태만 있는 것이 있고, 각각의 컬러가 지정되어 있습니다.

  • style은 하단 property, value에서 자세한 설명을 확인할 수 있습니다.

inactive state

active state

category_choice

  • text color

    • TextLabel

      • colorTheme : sysTextPrimary

  • icon color(left) : ui_cpnt_chip_line_icon_01

  • border color : ui_cpnt_chip_line_border_01

  • base color (hover 시)
    ui_cpnt_chip_fill_base_inactive

  • text color

    • TextLabel

      • colorTheme : usrTextBrandOnPrimary

  • icon color(right) : ui_cpnt_chip_fill_icon_active_01

  • base color : ui_cpnt_chip_fill_base_active_01

filter_single,

filter_multi

text color

  • TextLabel

    • colorTheme : sysTextSecondary

  • icon color(left) : ui_cpnt_chip_line_icon_02

  • base color : ui_cpnt_chip_fill_base_inactive

text color

  • TextLabel

    • colorTheme : usrTextBrandOnPrimary

  • icon color(left) : ui_cpnt_chip_fill_icon_active_01

  • base color : ui_cpnt_chip_fill_base_active_01

default state

removable

  • text color

    • TextLabel

      • colorTheme : sysTextSecondary

  • icon color(right) : ui_cpnt_chip_fill_icon_inactive

  • base color : ui_cpnt_chip_fill_base_inactive

label

  • text color

    • TextLabel

      • colorTheme : sysTextTertiary

  • border color : ui_cpnt_chip_line_border_01

time

  • text color

    • TextLabel

      • colorTheme : sysTextWhite

  • base color : ui_cpnt_chip_base_playtime

information

  • text color

    • TextLabel

      • colorTheme : sysTextPrimary

  • base color : ui_cpnt_chip_fill_base_inactive


Properties

displayType

칩의 유형을 결정합니다.

기획 지시사항

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

Type

enum

Default

'filter_single'

Enum Values Description

'category_choice'

카테고리 등을 선택할 때 사용합니다.

'filter_single'

필터의 역할을 하며, 여러 개의 칩들 중 한개 선택 시 사용합니다.

'filter_multi'

필터의 역할을 하며, 여러 개의 칩들 중 다중 선택 시 사용합니다.

*현재는 사용하지 않습니다.

'removable'

주로 Dropdown 내 멀티 선택 시 보여지는 칩입니다.

'label'

라벨(연령, 국가, 장르)을 보여주는 칩입니다.

*현재는 클릭 액션이 없습니다.

'time'

영상의 시간을 보여주는 칩이며, 클릭 액션이 없습니다.

'information'

정보를 보여주는 칩입니다.

*현재 채널별 프로필 아이디나 결제 종류에 사용하고 있습니다.

text

칩에 표시되는 텍스트입니다.

기획 지시사항

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

Type

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

Default

-

valueArray

Deprecated in 1.2

여러 개의 칩을 나열할 경우, 표시할 값입니다.

filterActiveNumber

Deprecated in 1.2

표시한 값들에서 현재 active 상태인 값을 표시합니다. 0부터 시작합니다. (3번째가 활성화일 경우 2를 적습니다.)
*style이 filter_single, filter_multi일 경우에만 적용됩니다.

filterIconMode

좌측 아이콘 유무를 결정합니다.
*style이 filter_single, filter_multi일 경우에만 적용됩니다.

기획 지시사항

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

Type

enum

Default

'none'

Enum Values Description

'none'

아이콘 없음

'left'

아이콘 좌측 위치

iconFillType

아이콘의 형태를 결정합니다.
*style이 filter_single, filter_multi일 경우에만 적용됩니다.

기획 지시사항

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

Type

enum

Default

'line'

Enum Values Description

'line'

line 형태의 아이콘을 사용합니다.

'fill'

fill 형태의 아이콘을 사용합니다.

iconName

아이콘 이름을 의미합니다.
*style이 filter_single, filter_multi일 경우에만 적용됩니다.

기획 지시사항

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

Type

enum

Default

-

Enum Values Description

Icon 컴포넌트의 iconName 값 중 하나를 부여합니다. (ic_xxx의 형식입니다.)

textColorOverride

Added in 1.4

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

*displayType : 'information' 인 경우에만 적용됩니다.

기획 지시사항

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

Type

enum

Default

-

Enum Values Description

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

backgroundColorOverride

Added in 1.4

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

*displayType : 'information' 인 경우에만 적용됩니다.

기획 지시사항

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

Type

enum

Default

-

Enum Values Description

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

activeChipId

Deprecated in 1.5

Added in 1.2

표시한 값들에서 현재 active 상태인 값을 표시합니다. 0부터 시작합니다.

기획 지시사항

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

Type

string | number

Default

0

chipId

Deprecated in 1.5

Added in 1.2

각 필터 칩에 부여된 고유값 입니다.

기획 지시사항

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

Type

string | number

Default

-

value

Added in 1.3

선택되어 활성화된 chip의 값입니다.

기획 지시사항

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

Type

string | number | null | boolean

Default

-

id

Added in 1.3

chip이 갖고 있는 고유한 값입니다.

기획 지시사항

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

Type

string | number | null | boolean

Default

-

onClickChip

Added in 1.2

칩 전체가 클릭 된 시점에 이벤트를 부여합니다.

기획 지시사항

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

Type

() => void;

Default

-

onClickXMarkIcon

Added in 1.2

칩 내부의 X부분이 클릭 된 시점에 이벤트를 부여합니다.

기획 지시사항

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

Type

() => void;

Default

-


문서 작성 정보

소유자 / 관리자

김혜진, 박윤규

변경 이력

  • 2022/08/30 : colorOverride 관련 prop 추가 - 김혜진

  • 2022/07/18 : category_choice 일 때, spec 수정 - 김혜진

  • 2022/04/29 : value와 id prop추가 - 안은수

  • 2022/03/24 : Property 기술방법 변경, 코드에만 있던 prop추가 - 안은수

  • 2022/02/25 : 개발 코드 배포여부 추가 - 안은수

  • 2022/02/19 : Property 기술방법 변경 - 박윤규

  • 2022/01/27 : prop 삭제 (valueArray, filterActiveNumber) - 김혜진

  • 2021/11/17 : style을 styleTheme로 수정 - 김혜진

  • 2021/11/16 : icon에 대한 spec 추가, prop 추가 - 김혜진

  • 2021/11/11 : 행간에 대한 내용 추가 - 김혜진

  • 2021/11/05 : profile_id를 information으로 수정 - 김혜진

  • 2021/11/03 : profile_id 유형 추가 - 김혜진

  • 2021/10/28 : chip의 전체 내용 변경 - 김혜진

  • 2021/10/27 : 텍스트 사이즈 수정 - 김혜진

  • 2021/10/26 : 텍스트 부분 TextLabel 값으로 수정 - 김혜진

  • 2021/09/30 : Spec 내용 추가 - 김혜진

  • 2021/09/13 : style 유형 추가

  • 2021/09/10-11 : Property 및 Value 업데이트 - 박윤규

  • 2021/09/11 : 최초작성 - 김혜진

JavaScript errors detected

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

If this problem persists, please contact our support.