Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

BackOffice Builder에서 제공하는 버튼 컴포넌트 종류와 버튼 UI 셋팅 방법을 간략히 소개한다.

Table of Contents

Component

버튼 클릭 시 발생하는 11가지 Event를 버튼 컴포넌트로 기본 제공한다.

  1. Link : 특정 링크 오픈

  2. Create : 신규 생성

  3. Delete : 선택 항목 삭제

  4. Save : 설정 내용을 저장

  5. Execute : 선택 내용 실행

  6. Modal : Modal 형태로 간단한 입력폼(답변 등록/수정) 출력

  7. Confirm : 확인창(Feedback)이 Modal 타입으로 출력

  8. Excel : 엑셀 다운로드 실행

  9. UploadExcel : 엑셀 업로드 창이 Modal 타입으로 출력

  10. Select : ??

  11. Download : 다운로드

  12. Call >빌더에서 생성 불가

  13. Call Back Check > 빌더에서 생성불가

Feedback Message

버튼 컴포넌트별 사용 가능한 메시지 형태와 설정 옵션은 아래와 같다.

...

액션 이후 메시지 : 액션 실행 후 성공/실패 메시지는 alert 형태로 고정되어 출력된다.

...

Summary

BackOffice Builder는 4개의 이벤트 컴포넌트를 제공한다. 이벤트 컴포넌트는 Button을 Event에 따라 세분화 한 것이다. 이 페이지에서는 모든 이벤트 버튼에 공통으로 적용되는 버튼 UI 유형과 상태 정보, 셋팅 옵션을 살펴보자.

No

Component

Success

Error

Alert

PopConfirm

ModalDescription

1

LinkButtonExecute

X

X

X

OImage Added

선택 내용 실행 버튼

2

CreateButtonLink

O

O

O

OImage Added

특정 링크 오픈 버튼

3

DeleteButtonExcelDownload

O

O

O

OImage Added

엑셀 다운로드를 진행하는 버튼

4

SaveButtonExcelUpload

O

O

O

O

5

Execute

O

O

O

O

6

Modal

O

O

O

X

7

Confirm

O

O

O

X

8

Excel(Download)

X

X

X

X

9

UploadExcel

X

X

X

X

10

Select

X

X

X

X

11

Download

X

X

X

X

Status
colourRed
titleneedcheck
Alert 옵션 명칭 확인 필요(Ant와 맞지 않음)

...

Setting

...

Result

...

https://ant.design/components/popconfirm/

...

https://ant.design/components/alert/

...

https://ant.design/components/modal/

...

Link Type

링크 버튼은 특정 URL을 11가지 타입으로 URL 오픈 할 수 있다.

  1. Modal : Modal로 출력

  2. Page : Page로 이동

  3. Window : 새로운 Window 창으로 출력

  4. Page in Component :

  5. Page In Modal

  6. Page In Grid

  7. Close Modal

  8. Set ParentId

  9. Function

  10. Print

  11. PDF

Modal

...

Comfirm

...

Excel(Download)

...

UploadExcel

...

UI

...

Image Added

엑셀 업로드 창을 Modal로 출력하는 버튼

...

Preview

이벤트 컴포넌트로 사용 되는 버튼은 총 5가지 유형으로 구분 할 수 있으며, 컴포넌트가 화면에 출력되는 UI는 다음과 같다.

1. Button Type

No

Basic Button

Description

1

Default Button

Image RemovedImage Added

일반적인 기본 버튼

2

Primary Button

완료 혹은 권장을 알리는 강조 버튼

3

Text Button

테이블, 폼에 사용되는 가벼운 버튼 유형으로 보조적인 작업에 주로 사용

4

Icon Button

Image RemovedImage Added

텍스트 없이 아이콘으로만 표현된 버튼으로 시각적 단서 제공

5

Text Button with Icon

기본 버튼에 아이콘을 추가한 형태

Status
colourYellow
titlenew
Text Button : Hide Border 토글버튼 필요

https://ionsdp.atlassian.net/browse/ICE4-1972

...

2. Button Status

버튼의 상태는 아래와 같이 4가지로 표현되며, 모든 버튼 컴포넌트에 공통으로 적용되어 있다.

Normal

Hover

Image AddedImage Added

Active

Disabled

Image AddedImage Added

  1. Normal : 사용자과 상호작용을 할 수 있는 기본 상태

  2. Hover : 마우스 오버 상태로 상호작용이 가능함을 더욱 강력하게 어필

  3. Active(Pressed) : 사용자가 버튼을 클릭/선택 한 상태를 네온 효과를 통해 강하게 표현함

  4. Disable : 조건이 맞지 않아 사용할 수 없는 비활성화 상태

...

Setting Options

BackOffice Builder의 Button > Setting > [Option] 설정을 통해 버튼 유형과 스타일을 변경한다.

Status
colourBlue
titleex
ButtonLink 셋팅 화면

...

1. Size

버튼의 크기는 아래와 같이 3가지로 선택 할 수 있다.

...

Label(버튼이름)에 입력된 텍스트 길이에 따라 버튼의 가로 길이는 가변적으로 변한다. 만약 특정 사이즈의 버튼이 필요하다면, Enable Style 토글버튼을 ON으로 변경하여 Button Style을 사용자가 직접 지정할 사이즈를 지정 할 수도 있다.

...

...

2. Shape

버튼의 모양은 사각형(Rectangle)과 원형(Circle) 2가지로 선택 할 수 있다.

Setting

Result

Image RemovedImage Added

...

3. Type

총 5가지의 버튼 타입을 선택할 수 있다.

Setting

Result

...

  • Ghost Type : 배경을 투명하게 만들고 텍스트 및 테두리 색상이 반전되는 버튼 타입으로, 컬러/복잡한 배경에서 주로 사용 (참고: Ant-Ghost)

...

Status
colourRed
titleneedcheck
고스트와 Dashed 스타일 함께 사용 불가

  • Dashed Type : 점선으로 둘러싸인 버튼 타입으로 일반적으로 작업을 추가하는데 사용

...

  • Danger Type : 삭제 또는 승인과 같은 위험 기능에 사용됨 (참고: Ant-Danger)

...

...

Status
colourRed
titleneedcheck
고스트가 배경 투명 기능이라면, Dashed 스타일과 함께 사용 불가인지 확인 필요

Status
colourRed
titleneed check
Danger Button 칼라 확인 필요

...

4. Icon, Hide Label/Border

아이콘을 선택하여 아이콘이 들어간 버튼을 만들거나, Label(버튼이름)과 Border(테두리) 숨김 여부 설정에 따라 아이콘만 있는 버튼을 만들 수도 있다.

...

아이콘을 선택하지 않고 Ghost Type을 선택 한 뒤, Hide Border를 ON으로 설정하면 텍스트 버튼이 된다.

Setting

Result

...

5.

...

Enable Style

작업을 사용 할 수 없도록 버튼을 비활성화 시켜야 한다면 Disable 옵션을 ON으로 설정한다. Enable Style을 활용하여 버튼 텍스트의 사이즈와 정렬, 글자와 버튼 칼라, 버튼의 사이즈(Width/Height)와 폰트 배치(Padding/Margin) 등을 직접 설정 할 수 있다.

...

Setting

...

Result

...

Disable{ON}

스타일 수정 방법은 아래와 같이 총 3가지 타입으로 진행할 수 있다. ( 참고: https://ionsdp.atlassian.net

...

Enable Style

...

/wiki/spaces/ICE4P/pages/1555300766/Table+List#Style-Set-Detail )

  • Simple CSS : 간단히 값만 입력

  • Code CSS : 직접 코드를 작성

  • Common CSS : 자주 사용되는 CSS를 선택

6. Disable

작업을 사용 할 수 없도록 버튼을 비활성화 시켜야 한다면 Disable 옵션을 ON으로 설정한다.

Setting

Result

Disable{ON}

Image Added