Skip to main content
Skip table of contents

Web - AdminListItem (Added in 2.0)

Added in 2.0

Definition

정의

AdminListItem

최적화 대상

Desktop

기획 배포

검토

디자인 가이드 배포

검토

개발 코드 배포

완료

Principle

AdminList에만 적용할 수 있는 리스트 아이템입니다. 정보들을 나열하여 한 눈에 비교가 필요할 때 사용합니다.

column이 10개까지 존재하지만 기획상에서 10개 모두 사용하는 것을 피해야합니다.
보통 5~6개 column을 사용하는 것이 적절합니다.

Things to Note

normal(기본 상태), hover(마우스 호버시), selected(선택 시) 3가지 상태가 있으며 기본적으로 selected는 클릭 시 보여지는 상태입니다.

이때 selectedState가 basic은 다시 selected 상태가 해제되지만(다른 곳을 클릭 시),
maintain일 때는 선택된 상태가 계속 유지됩니다. (VOD+ C00002SlideBannerElements 화면과 같은 경우)

구성

기획서 WF 작성 방법 참고

  • ToolBar와 BulkActionBar는 동시에 존재할 수 없으나(BulkActionBar가 나오면 ToolBar는 숨김처리됨) WF상 기입은 함께 해야 합니다.

  • ToolBar 또는 BulkActionBar 둘 중 하나만 존재해도 흰색 박스를 표현해야 합니다.


Spec

Guide

Size, Property

Rows

구성

내용

size(height)

  • high : 200px

  • medium : 100px

  • low : 64px

상하단 Padding을 포함한 값입니다.

image 영역

이미지 형태가 circular일 때 사이즈 64px

selection 영역

(column 1)

Web - IconButton 참고

  • baseSize : medium

  • iconSize : 16

  • shapeType : rectangle


  • Unselected

    • iconFillType : line

    • iconName : ic_checkbox_off

  • Selected

    • iconFillType : fill

    • iconName : ic_checkbox_on

column text

Web - TextLabel 참고

  • column 2

    • styleTheme : body2Bold

    • size가 medium, low 일 때

      • ellipsisMode : use

      • lineLimit : 2

    • size가 high 일 때

      • ellipsisMode : none

      • 스크롤

  • column 3~10

    • styleTheme : body2Regular

columnTextStyleTheme

  • column 3~10

    • styleTheme : body2Bold

padding

padding-bottom : 88px;

  • 스크롤 한 후 마지막 아이템리스트 밑에 88px 붙는 것 (FAB 고려)

Column

column이 사용되지 않으면, 숨김처리 됩니다.

구성

내용

width

  • column 1(selection 영역)

    • 40px

  • column 2(타이틀 또는 주요 내용 영역)

    • 반응형

  • column 3~10(나머지 정보 영역)

    • small : 56px

    • medium : 80px

    • large : 144px

  • 좌우 Padding을 포함하지 않은 값입니다.

Quick Action (우측 버튼)

구성

내용

보여지는 형태

fix (항상 고정된 영역을 가짐)

hover (버튼의 영역을 고정하기 어려운 좁은 영역에서 사용할 때 위로 띄움)

  • 우측 간격 spacing_f

touch area

56x56

text

TextLabel 참고

  • styleTheme : body2Regular

  • textAlign : center

Color 구성

Color Key

Rows

구성

내용

selection 영역

(column 1)

IconButton 참고

  • iconColorKey

    • unselected : ui_cpnt_selcontrols_icon_default

    • selected : ui_cpnt_selcontrols_icon_primary

  • baseColorKey : ui_cpnt_button_fill_base_transparent

column text

TextLabel 참고

  • column 2

    • colorTheme : sysTextPrimary

  • column 3~10

    • colorTheme : sysTextSecondary

columnTextStyleTheme

  • column 3~10

    • active : sysTextBrandSeconVariant

    • active2 : sysTextBrandPrimary

    • inactive : sysTextTertiary

    • report : sysTextError

    • report2 : sysTextWarning

base

  • default : ui_cpnt_datatable_base_default

  • hover : ui_cpnt_datatable_base_hover

  • selected : ui_cpnt_datatable_base_selected

Quick Action (우측 버튼)

구성

내용

text

TextLabel

  • colorTheme

    • 기본 : sysTextBrandPrimary

    • disalbed : ui_cpnt_textlabel_sys_brand_primary_opacity50

base

quickActionBtnType

  • fixed :ui_cpnt_datatable_text_button_base_01

  • floating : ui_cpnt_datatable_text_button_base_02


Properties

rowSize

행의 높이 사이즈를 결정합니다.

기획 지시사항

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

Type

enum

Default

'medium'

Enum Values Description

'high'

column2 영역에 이미지가 있을 수도 없을 수도 있지만,
많은 정보를 보여주는 경우에 사용합니다.

'medium'

column2 영역에 이미지가 있는 일반적인 경우에 사용합니다.

'low'

column2 영역에 이미지가 없고 간단한 정보를 보여주는 경우에 사용합니다.

 

selectionMode

좌측 선택 영역의 사용 여부를 결정합니다.
*AdminList의 selectionMode를 대신 사용합니다.

기획 지시사항

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

Type

enum

Default

'multi'

Enum Values Description

'none'

selection 영역(column 1)이 표시되지 않습니다.
체크박스가 사라집니다. 아이템을 클릭 했을 시 아무런 표시를 하지 않습니다.

'one'

아이템을 클릭 했을 시 선택된 아이템의 background-color만 줍니다.
하나만 선택해야할 때 (single select) 사용합니다.

'multi'

여러 개의 아이템을 선택할 수 있습니다. 체크박스를 사용합니다.

 

column2Type

column2의 게시글 표시 방법을 결정합니다.

기획 지시사항

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

Type

enum

Default

'image_text'

Enum Values Description

'image_text'

이미지와 텍스트가 같이 표시됩니다.

'text_only'

텍스트만 표시합니다.

 

imageSrc

게시글에 사용할 이미지 또는 썸네일을 표시합니다.

기획 지시사항

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

Type

string

Default

-

imageShapeType

이미지의 외관 형태를 결정합니다.

기획 지시사항

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

Type

enum

Default

'rectangle'

Enum Values Description

'round'

모서리가 둥근 직사각형 형태입니다.

'circular'

원형 형태입니다.

'rectangle'

직사각형 형태입니다.

 

imageScaleType

이미지를 채우는 방법을 결정합니다.

(사진이 영역을 꽉 채우지 못할때는 회색 배경이 채워집니다.)

기획 지시사항

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

Type

enum

Default

'cover'

Enum Values Description

'none'

원본 그대로 표시하며, 아무런 조치도 취하지 않음

'fill'

object-fit의 fill (fitXY)

'contain'

object-fit의 contain (center)

'cover'

object-fit의 cover (centerCrop)

imageRadius

이미지의 모서리 값을 결정합니다.
*shapeType : round일 때만 적용

기획 지시사항

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

Type

enum

Default

8

Enum Values Description

8

모서리 radius 8px

16

모서리 radius 16px

24

모서리 radius 24px

 

imageRatio

이미지의 비율을 결정합니다.

기획 지시사항

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

Type

enum

Default

'16_9'

Enum Values Description

'16_9'

16:9 비율

'4_3'

4:3 비율

'1_1'

1:1 비율

 

column2Text

게시글의 제목 또는 주요 내용을 표시합니다.

기획 지시사항

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

Type

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

Default

-

 

column3Text

column3의 내용을 표시합니다.

기획 지시사항

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

Type

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

Default

-

 

column3TextWidth

column3의 너비를 결정합니다.

*AdminList의 column3Width를 대신 사용합니다.

기획 지시사항

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

Type

enum

Default

'small'

Enum Values Description

'small'

56px

'medium'

80px

'large'

144px

'xlarge'

 

column3TextStyleTheme

column3 텍스트의 스타일을 결정합니다.

기획 지시사항

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

Type

enum

Default

'normal'

Enum Values Description

'normal'

기본 상태

'active'

활성화 상태 (녹색+bold)

'active2'

(blue + bold)

'inactive'

비활성화 상태 (비활성화 색+bold)

'report'

빨간색+bold

'report2'

주황색+bold

 

column4Text

column4의 내용을 표시합니다.

기획 지시사항

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

Type

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

Default

-

 

column4TextWidth

column4의 너비를 결정합니다.

*AdminList의 column4Width를 대신 사용합니다.

기획 지시사항

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

Type

enum

Default

'small'

Enum Values Description

'small'

56px

'medium'

80px

'large'

144px

'xlarge'

 

column4TextStyleTheme

column4 텍스트의 스타일을 결정합니다.

기획 지시사항

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

Type

enum

Default

'normal'

Enum Values Description

'normal'

기본 상태

'active'

활성화 상태 (녹색+bold)

'active2'

(blue + bold)

'inactive'

비활성화 상태 (비활성화 색+bold)

'report'

빨간색+bold

'report2'

주황색+bold

 

column5Text

column5의 내용을 표시합니다.

기획 지시사항

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

Type

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

Default

-

 

column5TextWidth

column5의 너비를 결정합니다.

*AdminList의 column5Width를 대신 사용합니다.

기획 지시사항

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

Type

enum

Default

'small'

Enum Values Description

'small'

56px

'medium'

80px

'large'

144px

'xlarge'

 

column5TextStyleTheme

column5 텍스트의 스타일을 결정합니다.

기획 지시사항

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

Type

enum

Default

'normal'

Enum Values Description

'normal'

기본 상태

'active'

활성화 상태 (녹색+bold)

'active2'

(blue + bold)

'inactive'

비활성화 상태 (비활성화 색+bold)

'report'

빨간색+bold

'report2'

주황색+bold

 

column6Text

column6의 내용을 표시합니다.

기획 지시사항

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

Type

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

Default

-

 

column6TextWidth

column6의 너비를 결정합니다.

*AdminList의 column6Width를 대신 사용합니다.

기획 지시사항

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

Type

enum

Default

'small'

Enum Values Description

'small'

56px

'medium'

80px

'large'

144px

'xlarge'

 

column6TextStyleTheme

Added in 1.3

column6 텍스트의 스타일을 결정합니다.

기획 지시사항

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

Type

enum

Default

'normal'

Enum Values Description

'normal'

기본 상태

'active'

활성화 상태 (녹색+bold)

'active2'

(blue + bold)

'inactive'

비활성화 상태 (비활성화 색+bold)

'report'

빨간색+bold

'report2'

주황색+bold

 

column7Text

column7의 내용을 표시합니다.

기획 지시사항

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

Type

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

Default

-

 

column7TextWidth

column7의 너비를 결정합니다.

*AdminList의 column7Width를 대신 사용합니다.

기획 지시사항

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

Type

enum

Default

'small'

Enum Values Description

'small'

56px

'medium'

80px

'large'

144px

'xlarge'

 

column7TextStyleTheme

column7 텍스트의 스타일을 결정합니다.

기획 지시사항

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

Type

enum

Default

'normal'

Enum Values Description

'normal'

기본 상태

'active'

활성화 상태 (녹색+bold)

'active2'

(blue + bold)

'inactive'

비활성화 상태 (비활성화 색+bold)

'report'

빨간색+bold

'report2'

주황색+bold

 

column8Text

column8의 내용을 표시합니다.

기획 지시사항

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

Type

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

Default

-

 

column8TextWidth

column8의 너비를 결정합니다.

*AdminList의 column8Width를 대신 사용합니다.

기획 지시사항

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

Type

enum

Default

'small'

Enum Values Description

'small'

56px

'medium'

80px

'large'

144px

'xlarge'

 

column8TextStyleTheme

column8 텍스트의 스타일을 결정합니다.

기획 지시사항

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

Type

enum

Default

'normal'

Enum Values Description

'normal'

기본 상태

'active'

활성화 상태 (녹색+bold)

'active2'

(blue + bold)

'inactive'

비활성화 상태 (비활성화 색+bold)

'report'

빨간색+bold

'report2'

주황색+bold

 

column9Text

column9의 내용을 표시합니다.

기획 지시사항

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

Type

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

Default

-

 

column9TextWidth

column9의 너비를 결정합니다.

*AdminList의 column9Width를 대신 사용합니다.

기획 지시사항

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

Type

enum

Default

'small'

Enum Values Description

'small'

56px

'medium'

80px

'large'

144px

'xlarge'

 

column9TextStyleTheme

column9 텍스트의 스타일을 결정합니다.

기획 지시사항

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

Type

enum

Default

'normal'

Enum Values Description

'normal'

기본 상태

'active'

활성화 상태 (녹색+bold)

'active2'

(blue + bold)

'inactive'

비활성화 상태 (비활성화 색+bold)

'report'

빨간색+bold

'report2'

주황색+bold

 

column10Text

column10의 내용을 표시합니다.

기획 지시사항

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

Type

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

Default

-

 

column10TextWidth

column10의 너비를 결정합니다.

*AdminList의 column10Width를 대신 사용합니다.

기획 지시사항

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

Type

enum

Default

'small'

Enum Values Description

'small'

56px

'medium'

80px

'large'

144px

'xlarge'

 

column10TextStyleTheme

column10 텍스트의 스타일을 결정합니다.

기획 지시사항

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

Type

enum

Default

'normal'

Enum Values Description

'normal'

기본 상태

'active'

활성화 상태 (녹색+bold)

'active2'

(blue + bold)

'inactive'

비활성화 상태 (비활성화 색+bold)

'report'

빨간색+bold

'report2'

주황색+bold

 

quickActionBtnMode

우측 퀵 액션 버튼의 사용 개수를 결정합니다.

*AdminList의 quickActionBtnMode를 대신 사용합니다.

기획 지시사항

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

Type

enum

Default

'btn_amount2'

Enum Values Description

'none'

버튼이 표시되지 않습니다. (퀵 액션 버튼이 없습니다.)

'btn_amount1'

1개

'btn_amount2'

2개

'btn_amount3'

3개

 

quickActionBtn1Text

퀵 액션 버튼에서 우측 기준 1번 버튼의 텍스트입니다.

*AdminList의 quickActionBtn1Text를 대신 사용합니다.

기획 지시사항

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

Type

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

Default

-

 

quickActionBtn2Text

퀵 액션 버튼에서 우측 기준 2번 버튼의 텍스트입니다.

*AdminList의 quickActionBtn2Text를 대신 사용합니다.

기획 지시사항

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

Type

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

Default

-

 

quickActionBtn3Text

퀵 액션 버튼에서 우측 기준 3번 버튼의 텍스트입니다.

*AdminList의 quickActionBtn3Text를 대신 사용합니다.

기획 지시사항

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

Type

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

Default

-

 

quickActionBtnType

우측 액션 버튼의 형태를 결정합니다.

*AdminList의 quickActionBtnType를 대신 사용합니다.

기획 지시사항

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

Type

enum

Default

'fix'

Enum Values Description

'fix'

우측 액션 버튼이 고정 영역을 가지고 있습니다.

'hover'

우측 액션 버튼을 리스트 아이템 위에 띄웁니다.

quickActionBtn1State

우측 퀵 액션 버튼에서 우측 기준 1번 버튼의 상태를 결정합니다.

*AdminList의 quickActionBtn1State를 대신 사용합니다.

기획 지시사항

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

Type

enum

Default

'normal'

Enum Values Description

'normal'

기본 상태

'disabled'

비활성화 상태

 

quickActionBtn2State

우측 퀵 액션 버튼에서 우측 기준 2번 버튼의 상태를 결정합니다.

*AdminList의 quickActionBtn2State를 대신 사용합니다.

기획 지시사항

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

Type

enum

Default

'normal'

Enum Values Description

'normal'

기본 상태

'disabled'

비활성화 상태

 

quickActionBtn3State

우측 퀵 액션 버튼에서 우측 기준 3번 버튼의 상태를 결정합니다.

*AdminList의 quickActionBtn3State를 대신 사용합니다.

기획 지시사항

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

Type

enum

Default

'normal'

Enum Values Description

'normal'

기본 상태

'disabled'

비활성화 상태

 

selectedState

선택 상태를 유지할 것인지에 대한 결정을 합니다.

*'maintain'일 경우 AdminList의 maintainIds 프롭을 사용합니다.

기획 지시사항

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

Type

enum

Default

'basic'

Enum Values Description

'basic'

선택 후 어떤 다른 액션을 취하면 선택된 상태가 해제됩니다. (일반적인 형태)

'maintain'

선택된 상태를 유지합니다.
*C00002SlideBannerElements 화면이 대표적

 

id*

체크박스 선택시 요소 구분을 위한 값입니다.

기획 지시사항

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

Type

number

Default

-

flexibleHideInfoMode

일정 너비 이하가 되면 특정 정보들이 숨겨지도록 처리할지에 대한 여부를 결정합니다.

*AdminList의 flexibleHideInfoMode를 대신 사용합니다.

기획 지시사항

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

Type

enum

Default

'use'

Enum Values Description

'none'

모든 화면 사이즈에서 모든 정보가 보여집니다.

'use'

1400px기준으로, 전체 화면 사이즈가 해당 너비 이하가 되면 column3부터 column10까지가 숨겨집니다.

 

onClickQuickActionBtn1

QuickActionBtn1이 클릭이 된 시점에 이벤트를 부여합니다.

*AdminList의 onClickQuickActionBtn1를 대신 사용합니다.

기획 지시사항

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

Type

(id: number) => void

Default

-

onClickQuickActionBtn2

QuickActionBtn2이 클릭이 된 시점에 이벤트를 부여합니다.

*AdminList의 onClickQuickActionBtn2를 대신 사용합니다.

기획 지시사항

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

Type

(id: number) => void

Default

-

onClickQuickActionBtn3

QuickActionBtn3이 클릭이 된 시점에 이벤트를 부여합니다.

*AdminList의 onClickQuickActionBtn3를 대신 사용합니다.

기획 지시사항

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

Type

(id: number) => void

Default

-

onClickItem

*AdminList의 onSelect prop과 연결되어있는 개발상 prop입니다. 직접적으로 사용하는 경우는 없습니다.

기획 지시사항

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

Type

(id: number) => void

Default

-


문서 작성 정보

소유자 / 관리자

김혜진, 박윤규, 안은수

변경 이력

  • 2023/03/24 : text 관련 prop들 타입 변경 - 안은수

  • 2023/03/10 : AdminListItem 문서 복제, 버전 정보 수정 - 안은수

JavaScript errors detected

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

If this problem persists, please contact our support.