Web - AdminList (Deprecated in 2.2)
Deprecated in 2.2
Added in 1.3
BulkActionBar, HeaderRow가 포함된 컴포넌트입니다.
Definition
정의 | AdminList |
최적화 대상 | Desktop |
기획 배포 | 완료 |
디자인 가이드 배포 | 완료 |
개발 코드 배포 | 완료 |
Principle
List Pattern은 ListItem을 담는 요소입니다.
HeaderRow, BulkActionBar가 있습니다.
HeaderRow엔 column이 10개까지 존재하지만 기획상 10개 모두 사용하는 것을 피해야합니다.
보통 5~6개 column을 사용하는 것을 권장합니다.
특히 2단 레이아웃과 같이 보여지는 영역이 좁을 경우 정보의 컬럼의 수를 적게 사용해야 하기 때문에 column을 4개까지 표시하는 것을 권장합니다. (column4HeaderText까지 사용 가능)

HeaderRow, BulkActionBar
selectMode의 multi를 사용할 시, Bulk Action Bar가 생깁니다.
Bulk Action Bar에 사용되는 Dropdown과 Button은 서로 연관성이 있는 것이 아닌 개별 요소입니다.
구성

안에 들어가는 ListItem은 AdminListItem 의 구성 및 스펙을 따라갑니다.
Spec
Guide

Size, Property
간격 가이드
전체가 다 조합되었을 때 배치 순서 : Header Bar - TextLabel - FilterBar - Bulk Action Bar - Header Row
HeaderBar에 포함된 하단 24px은 설명문구가 있을 때는 숨김 처리 됩니다. 그 외에는 24px을 사용합니다.
(하단 이미지 참고)ListItem들 사이 간격 : 0px
columnHeader 영역은 AdminListItem의 columnText 영역과 너비가 같아야 합니다. (서로 같은 열에 놓여져 보이게)

Header Row
구성 | 내용 |
height | 48px |
selection 영역 (column 1) | IconButton 참고
|
text | TextLabel 참고
|
divider | Divider 참고
|
Bulk Action Bar
구성 | 내용 |
height | 56px |
text | TextLabel 참고
|
Dropdown |
|
TextButton |
|
divider | Divider 참고
|
emptyState
아직 아무것도 추가되지 않았을때 뜨는 문구입니다.
구성 | 내용 |
text | TextLebel
|

Color 구성

Color Key
Header Row
구성 | 내용 |
selection 영역 | IconButton 참고
|
text | TextLabel 참고
|
base |
|
Divider | Divider 참고 |
Bulk Action Bar
구성 | 내용 |
text | TextLabel
|
Dropdown |
|
TextButton |
|
base |
|
emptyState
아직 아무것도 추가되지 않았을때 뜨는 문구입니다.
구성 | 내용 |
emptyText | TextLabel
|
Properties
selectionMode
Added in 1.3
좌측 선택 영역의 사용 여부를 결정합니다.
*ListItem에서는 해당 prop 설정을 그대로 가져다 씁니다.
기획 지시사항
기획서 상 작성 방법 : Enum Values 중 하나를 사용함
Type |
|
---|---|
Default |
|
Enum Values Description | |
---|---|
| selection 영역(column 1)이 표시되지 않습니다. |
|
Added in 1.3 체크박스가 사라집니다. 아이템을 클릭 했을 시 선택된 아이템의 background-color만 줍니다. |
|
Added in 1.3 여러 개의 아이템을 선택할 수 있습니다. 체크박스를 사용합니다. |
headerRowMode
Added in 1.3
HeaderRow의 숨김 여부를 결정합니다.
기획 지시사항
기획서 상 작성 방법 : Enum Values 중 하나를 사용함
Type |
|
---|---|
Default |
|
Enum Values Description | |
---|---|
| HeaderRow를 사용하지 않습니다. |
| HeaderRow를 사용합니다. |
column2HeaderText*
Added in 1.3
column2의 Header 텍스트를 표시합니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
|
---|---|
Default | - |
column3HeaderText
Added in 1.3
column3의 Header 텍스트를 표시합니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
|
---|---|
Default | - |
column3Width
Added in 1.3
column3의 width를 결정합니다.
*ListItem에서는 해당 prop 설정을 그대로 가져다 씁니다.
기획 지시사항
기획서 상 작성 방법 : Enum Values 중 하나를 사용함
Type |
|
---|---|
Default |
|
Enum Values Description | |
---|---|
| |
| |
|
column4HeaderText
Added in 1.3
column4의 Header 텍스트를 표시합니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
|
---|---|
Default | - |
column4Width
Added in 1.3
column4의 width를 결정합니다.
*ListItem에서는 해당 prop 설정을 그대로 가져다 씁니다.
기획 지시사항
기획서 상 작성 방법 : Enum Values 중 하나를 사용함
Type |
|
---|---|
Default |
|
Enum Values Description | |
---|---|
| |
| |
|
column5HeaderText
Added in 1.3
column5의 Header 텍스트를 표시합니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
|
---|---|
Default | - |
column5Width
Added in 1.3
column5의 width를 결정합니다.
*ListItem에서는 해당 prop 설정을 그대로 가져다 씁니다.
기획 지시사항
기획서 상 작성 방법 : Enum Values 중 하나를 사용함
Type |
|
---|---|
Default |
|
Enum Values Description | |
---|---|
| |
| |
|
column6HeaderText
Added in 1.3
column6의 Header 텍스트를 표시합니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
|
---|---|
Default | - |
column6Width
Added in 1.3
column6의 width를 결정합니다.
*ListItem에서는 해당 prop 설정을 그대로 가져다 씁니다.
기획 지시사항
기획서 상 작성 방법 : Enum Values 중 하나를 사용함
Type |
|
---|---|
Default |
|
Enum Values Description | |
---|---|
| |
| |
|
column7HeaderText
Added in 1.3
column7의 Header 텍스트를 표시합니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
|
---|---|
Default | - |
column7Width
Added in 1.3
column7의 width를 결정합니다.
*ListItem에서는 해당 prop 설정을 그대로 가져다 씁니다.
기획 지시사항
기획서 상 작성 방법 : Enum Values 중 하나를 사용함
Type |
|
---|---|
Default |
|
Enum Values Description | |
---|---|
| |
| |
|
column8HeaderText
Added in 1.3
column8의 Header 텍스트를 표시합니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
|
---|---|
Default | - |
column8Width
Added in 1.3
column8의 width를 결정합니다.
*ListItem에서는 해당 prop 설정을 그대로 가져다 씁니다.
기획 지시사항
기획서 상 작성 방법 : Enum Values 중 하나를 사용함
Type |
|
---|---|
Default |
|
Enum Values Description | |
---|---|
| |
| |
|
column9HeaderText
Added in 1.3
column9의 Header 텍스트를 표시합니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
|
---|---|
Default | - |
column9Width
Added in 1.3
column9의 width를 결정합니다.
*ListItem에서는 해당 prop 설정을 그대로 가져다 씁니다.
기획 지시사항
기획서 상 작성 방법 : Enum Values 중 하나를 사용함
Type |
|
---|---|
Default |
|
Enum Values Description | |
---|---|
| |
| |
|
column10HeaderText
Added in 1.3
column10의 Header 텍스트를 표시합니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
|
---|---|
Default | - |
column10Width
Added in 1.3
column10의 width를 결정합니다.
*ListItem에서는 해당 prop 설정을 그대로 가져다 씁니다.
기획 지시사항
기획서 상 작성 방법 : Enum Values 중 하나를 사용함
Type |
|
---|---|
Default |
|
Enum Values Description | |
---|---|
| |
| |
|
dropdownMode
Added in 1.3
드롭다운의 사용 갯수를 결정합니다.
기획 지시사항
기획서 상 작성 방법 : Enum Values 중 하나를 사용함
Type |
|
---|---|
Default |
|
Enum Values Description | |
---|---|
| 드롭다운을 사용하지 않습니다. |
| 드롭다운을 1개 사용합니다. |
| 드롭다운을 2개 사용합니다. |
| 드롭다운을 3개 사용합니다. |
dropdown1Value
Added in 1.4
드롭다운의 값입니다. (예외 상황이 있을 때 원래 값이나 다른 값을 설정하기위해 주로 쓰입니다.)
기획 지시사항
기획서 상 작성 방법 : 기획자가 직접 prop을 기술하지 않음
Type |
CODE
|
---|---|
Default | - |
dropdown2Value
Added in 1.4
드롭다운의 값입니다. (예외 상황이 있을 때 원래 값이나 다른 값을 설정하기위해 주로 쓰입니다.)
기획 지시사항
기획서 상 작성 방법 : 기획자가 직접 prop을 기술하지 않음
Type |
CODE
|
---|---|
Default | - |
dropdown3Value
Added in 1.4
드롭다운의 값입니다. (예외 상황이 있을 때 원래 값이나 다른 값을 설정하기위해 주로 쓰입니다.)
기획 지시사항
기획서 상 작성 방법 : 기획자가 직접 prop을 기술하지 않음
Type |
CODE
|
---|---|
Default | - |
dropdown1DefaultText
Added in 1.3
지정된 기본 값을 표시합니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
CODE
|
---|---|
Default | - |
dropdown2DefaultText
Added in 1.3
지정된 기본 값을 표시합니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
CODE
|
---|---|
Default | - |
dropdown3DefaultText
Added in 1.3
지정된 기본 값을 표시합니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
CODE
|
---|---|
Default | - |
dropdown1HintText
Added in 1.4
드롭다운1 선택 전 사용자에게 보여질 기본 텍스트입니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
CODE
|
---|---|
Default | - |
dropdown2HintText
Added in 1.4
드롭다운1 선택 전 사용자에게 보여질 기본 텍스트입니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
CODE
|
---|---|
Default | - |
dropdown3HintText
Added in 1.4
드롭다운1 선택 전 사용자에게 보여질 기본 텍스트입니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
CODE
|
---|---|
Default | - |
dropdown1ValueArray
Added in 1.3
드롭다운에 표시할 값 목록입니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
CODE
|
---|---|
Default | - |
dropdown2ValueArray
Added in 1.3
드롭다운에 표시할 값 목록입니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
CODE
|
---|---|
Default | - |
dropdown3ValueArray
Added in 1.3
드롭다운에 표시할 값 목록입니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
CODE
|
---|---|
Default | - |
quickActionBtnType
Added in 1.3
우측 액션 버튼의 형태를 결정합니다.
*ListItem에서는 해당 prop 설정을 그대로 가져다 씁니다.
기획 지시사항
기획서 상 작성 방법 : Enum Values 중 하나를 사용함
Type |
|
---|---|
Default |
|
Enum Values Description | |
---|---|
| 우측 액션 버튼이 고정 영역을 가지고 있습니다. |
| 우측 액션 버튼을 리스트 아이템 위에 띄웁니다. |
quickActionBtnMode
Added in 1.3
퀵액션 버튼 사용 개수를 결정합니다.
*ListItem에서는 해당 prop 설정을 그대로 가져다 씁니다.
기획 지시사항
기획서 상 작성 방법 : Enum Values 중 하나를 사용함
Type |
|
---|---|
Default |
|
Enum Values Description | |
---|---|
| 메인 버튼을 사용하지 않습니다. |
| 퀵액션 버튼을 1개 사용합니다. |
| 퀵액션 버튼을 2개 사용합니다. |
| 퀵액션 버튼을 3개 사용합니다. |
quickActionBtn1Text
Added in 1.3
우측에서 1번째 퀵 액션 버튼의 텍스트입니다.
*ListItem에서는 해당 prop 설정을 그대로 가져다 씁니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
|
---|---|
Default | - |
quickActionBtn2Text
Added in 1.3
우측에서 2번째 퀵 액션 버튼의 텍스트입니다.
*ListItem에서는 해당 prop 설정을 그대로 가져다 씁니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
|
---|---|
Default | - |
quickActionBtn3Text
Added in 1.3
우측에서 3번째 퀵 액션 버튼의 텍스트입니다.
*ListItem에서는 해당 prop 설정을 그대로 가져다 씁니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
|
---|---|
Default | - |
quickActionBtn1State (Deprecated in 1.6)
Deprecated in 1.6
Added in 1.3
퀵 액션 우측에서 1번 버튼의 활성화 상태를 나타냅니다.
*ListItem에서는 해당 prop 설정을 그대로 가져다 씁니다.
기획 지시사항
기획서 상 작성 방법 : Enum Values 중 하나를 사용함
Type |
|
---|---|
Default | - |
Enum Values Description | |
---|---|
| 기본 상태 입니다. |
| 비활성화 상태입니다. |
quickActionBtn2State (Deprecated in 1.6)
Deprecated in 1.6
Added in 1.3
퀵 액션 우측에서 2번 버튼의 활성화 상태를 나타냅니다.
*ListItem에서는 해당 prop 설정을 그대로 가져다 씁니다.
기획 지시사항
기획서 상 작성 방법 : Enum Values 중 하나를 사용함
Type |
|
---|---|
Default | - |
Enum Values Description | |
---|---|
| 기본 상태 입니다. |
| 비활성화 상태입니다. |
quickActionBtn3State (Deprecated in 1.6)
Deprecated in 1.6
Added in 1.3
퀵 액션 우측에서 3번 버튼의 활성화 상태를 나타냅니다.
*ListItem에서는 해당 prop 설정을 그대로 가져다 씁니다.
기획 지시사항
기획서 상 작성 방법 : Enum Values 중 하나를 사용함
Type |
|
---|---|
Default | - |
Enum Values Description | |
---|---|
| 기본 상태 입니다. |
| 비활성화 상태입니다. |
mBtnMode (Deprecated in 1.5)
Deprecated in 1.5
Added in 1.3
메인 버튼의 사용 갯수를 결정합니다.
기획 지시사항
기획서 상 작성 방법 : Enum Values 중 하나를 사용함
Type |
|
---|---|
Default |
|
Enum Values Description | |
---|---|
|
|
|
|
|
|
|
|
mBtn1Text (Deprecated in 1.5)
Deprecated in 1.5
Added in 1.3
좌측부터 사용되는 버튼 1에 대한 텍스트값을 표시합니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
|
---|---|
Default | - |
mBtn2Text (Deprecated in 1.5)
Deprecated in 1.5
Added in 1.3
좌측부터 사용되는 버튼 2에 대한 텍스트값을 표시합니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
|
---|---|
Default | - |
mBtn3Text (Deprecated in 1.5)
Deprecated in 1.5
Added in 1.3
좌측부터 사용되는 버튼 3에 대한 텍스트값을 표시합니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
|
---|---|
Default | - |
tBtnMode
Added in 1.4
텍스트 버튼의 사용 갯수를 결정합니다.
기획 지시사항
기획서 상 작성 방법 : Enum Values 중 하나를 사용함
Type |
|
---|---|
Default |
|
Enum Values Description | |
---|---|
| 텍스트 버튼을 사용하지 않습니다. |
| 텍스트 버튼을 1개 사용합니다. |
| 텍스트 버튼을 2개 사용합니다. |
| 텍스트 버튼을 3개 사용합니다. |
tBtn1Text
Added in 1.4
좌측부터 사용되는 버튼 1에 대한 텍스트값을 표시합니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
|
---|---|
Default | - |
tBtn2Text
Added in 1.4
좌측부터 사용되는 버튼 2에 대한 텍스트값을 표시합니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
|
---|---|
Default | - |
tBtn3Text
Added in 1.4
좌측부터 사용되는 버튼 3에 대한 텍스트값을 표시합니다.
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
|
---|---|
Default | - |
emptyText
Added in 1.3
아무런 게시글이 업로드 되지 않았을 때 표시될 문구
기획 지시사항
기획서 상 작성 방법 : 텍스트만 기술
Type |
|
---|---|
Default | - |
scrollMode
Added in 1.3
스크롤을 사용할 지에 대한 여부를 결정합니다.
기획 지시사항
기획서 상 작성 방법 : Enum Values 중 하나를 사용함
Type |
|
---|---|
Default |
|
Enum Values Description | |
---|---|
| 모든 스크롤이 불가능하고, 아이템을 단순히 나열합니다. |
| 무한 스크롤을 사용합니다. |
| 페이지네이션 형식을 사용하고, 제한적으로만 스크롤을 사용합니다. |
scrollVisibleType
Added in 1.3
스크롤을 표시할 지에 대한 여부를 결정합니다.
기획 지시사항
기획서 상 작성 방법 : Enum Values 중 하나를 사용함
Type |
|
---|---|
Default |
|
Enum Values Description | |
---|---|
| 움직일 때에만 표시하고 더이상 표시하지 않습니다. |
| 스크롤을 아예 표시하지 않습니다.
CODE
|
| 항상 표시합니다.
CODE
|
headerRowCheckboxName
Added in 1.4
headerRow에 있는 Checkbox에 name을 부여할 수 있습니다.
기획 지시사항
기획서 상 작성 방법 : 기획자가 직접 prop을 기술하지 않음
Type |
|
---|---|
Default |
|
flexibleHideInfoMode
Added in 1.9
일정 너비 이하가 되면 특정 정보들이 숨겨지도록 처리할지에 대한 여부를 결정합니다.
기획 지시사항
기획서 상 작성 방법 : Enum Values 중 하나를 사용함
Type |
|
---|---|
Default |
|
Enum Values Description | |
---|---|
| 모든 화면 사이즈에서 모든 정보가 보여집니다. |
| 1400px기준으로, 전체 화면 사이즈가 해당 너비 이하가 되면 column3부터 column10까지가 숨겨집니다. |
onChangeDropdown1
Added in 1.4
Dropdown1의 데이터가 변경되는 시점에 이벤트를 부여합니다.
기획 지시사항
기획서 상 작성 방법 : 기획자가 직접 prop을 기술하지 않음
Type |
CODE
|
---|---|
Default | - |
onChangeDropdown2
Added in 1.4
Dropdown2의 데이터가 변경되는 시점에 이벤트를 부여합니다.
기획 지시사항
기획서 상 작성 방법 : 기획자가 직접 prop을 기술하지 않음
Type |
CODE
|
---|---|
Default | - |
onChangeDropdown3
Added in 1.4
Dropdown3의 데이터가 변경되는 시점에 이벤트를 부여합니다.
기획 지시사항
기획서 상 작성 방법 : 기획자가 직접 prop을 기술하지 않음
Type |
CODE
|
---|---|
Default | - |
onClickMBtn1 (Deprecated in 1.5)
Deprecated in 1.5
Added in 1.4
MBtn1이 클릭이 된 시점에 이벤트를 부여합니다.
기획 지시사항
기획서 상 작성 방법 : 기획자가 직접 prop을 기술하지 않음
Type |
|
---|---|
Default | - |
onClickMBtn2 (Deprecated in 1.5)
Deprecated in 1.5
Added in 1.4
MBtn2이 클릭이 된 시점에 이벤트를 부여합니다.
기획 지시사항
기획서 상 작성 방법 : 기획자가 직접 prop을 기술하지 않음
Type |
|
---|---|
Default | - |
onClickMBtn3 (Deprecated in 1.5)
Deprecated in 1.5
Added in 1.4
MBtn3이 클릭이 된 시점에 이벤트를 부여합니다.
기획 지시사항
기획서 상 작성 방법 : 기획자가 직접 prop을 기술하지 않음
Type |
|
---|---|
Default | - |
onClickTBtn1
Added in 1.4
TBtn1이 클릭이 된 시점에 이벤트를 부여합니다.
기획 지시사항
기획서 상 작성 방법 : 기획자가 직접 prop을 기술하지 않음
Type |
|
---|---|
Default | - |
onClickTBtn2
Added in 1.4
TBtn2이 클릭이 된 시점에 이벤트를 부여합니다.
기획 지시사항
기획서 상 작성 방법 : 기획자가 직접 prop을 기술하지 않음
Type |
|
---|---|
Default | - |
onClickTBtn3
Added in 1.4
TBtn3이 클릭이 된 시점에 이벤트를 부여합니다.
기획 지시사항
기획서 상 작성 방법 : 기획자가 직접 prop을 기술하지 않음
Type |
|
---|---|
Default | - |
onClickQuickActionBtn1
Added in 1.4
QuickActionBtn1이 클릭이 된 시점에 이벤트를 부여합니다.
기획 지시사항
기획서 상 작성 방법 : 기획자가 직접 prop을 기술하지 않음
Type |
|
---|---|
Default | - |
onClickQuickActionBtn2
Added in 1.4
QuickActionBtn2이 클릭이 된 시점에 이벤트를 부여합니다.
기획 지시사항
기획서 상 작성 방법 : 기획자가 직접 prop을 기술하지 않음
Type |
|
---|---|
Default | - |
onClickQuickActionBtn3
Added in 1.4
QuickActionBtn3이 클릭이 된 시점에 이벤트를 부여합니다.
기획 지시사항
기획서 상 작성 방법 : 기획자가 직접 prop을 기술하지 않음
Type |
|
---|---|
Default | - |
children
Added in 1.4
AdminList에 들어갈 자식 요소입니다. 현재는 AdminListItem 컴포넌트만 위치시킬 수 있습니다.
기획 지시사항
기획서 상 작성 방법 : 기획자가 직접 prop을 기술하지 않음
Type |
|
---|---|
Default | - |
onSelect
Added in 1.4
선택이 된 시점에 이벤트를 부여합니다.
기획 지시사항
기획서 상 작성 방법 : 기획자가 직접 prop을 기술하지 않음
Type |
|
---|---|
Default | - |
selectedIds
Added in 1.4
선택된 아이템의 id 배열입니다. id는 숫자 타입만 허용합니다.
기획 지시사항
기획서 상 작성 방법 : 기획자가 직접 prop을 기술하지 않음
Type |
|
---|---|
Default | - |
maintainIds
Added in 1.4
maintain 상태를 유지시킬 아이템의 id 배열입니다. id는 숫자 타입만 허용합니다.
기획 지시사항
기획서 상 작성 방법 : 기획자가 직접 prop을 기술하지 않음
Type |
|
---|---|
Default | - |
문서 작성 정보
소유자 / 관리자 | 김혜진, 박윤규 |
---|---|
변경 이력 |
|