Kakao Work::Block Kit 구성 및 정책::Action Block

페이지 이동경로

Action Block

Action Block(액션 블록)은 말풍선 안에서 여러 개의 버튼을 하나의 행에 표현할 수 있는 레이아웃 블록입니다.

Action Block
블록 유형 블록명 엘리먼트 레이아웃 블록 조합된 엘리먼트
말풍선 Action Block X O Button Block

기능 소개

Action Block은 Button Block을 엘리먼트로 활용하는 레이아웃 블록입니다. 한 개의 행에 2개 이상의 버튼(최대 3개)을 나란히 배치하는 경우에 사용되며, 기본 속성은 Button Block과 동일합니다.

안내
한 개의 행에 하나의 버튼을 표현하고 싶은 경우에는 Button Block을 활용합니다.

Action Block 예시 그림Action Block 예시

기능 리스트
기능 설명
버튼 표현하기 1개의 행에 2-3개의 버튼을 표현 가능(최대 3개)
버튼 명 최대 20자까지 입력 가능
- 버튼 사이즈에 따라 말줄임 처리
- 가운데 정렬로 표시
버튼 색상 3개의 버튼 색상 조합 가능
default: 일반적인 표현
primary: 우선순위로 강조
danger: 위험, 경고의 표현

블록 속성

블록 속성
속성 타입 필수 여부 설명
type String 필수 타입 고정값
Object[] 필수 Button Block의 목록
type String 필수 타입 고정값
text String 필수 버튼 레이블
style String 필수 버튼 스타일
default: 일반적인 표현
primary: 우선순위로 강조
danger: 위험, 경고의 표현
action_type String 선택 버튼 선택 시 수행할 동작 명령어
open_inapp_browser: value 속성에 담긴 URL을 인앱브라우저로 연결
open_system_browser: value 속성에 담긴 URL을 시스템(System) 브라우저로 연결
open_external_app: value 속성에 담긴 custom app.scheme을 호출
submit_action: action_name, value, 문맥 정보들을 고객사 서버에 콜백으로 전달
call_modal: Modal 창을 띄우는 요청이며, value 속성값으로 서버에 요청하여 Modal 데이터를 가져와서 표시
action_name String 선택 여러 액션 엘리먼트 중에 어떤 것을 눌렀는지 구분하기 위해 사용
- 주로 서버 API 호출 시에 사용
value String 선택 버튼의 액션 수행 시, 추가 정보를 담을 수 있는 속성
- 자유 포맷으로 Query Parameter, String Encoded JSON 등을 사용할 수 있음
안내
각 버튼의 속성은 Action Block의 엘리먼트인 Button Block과 동일하며, 이에 대한 자세한 설명은 Button Block을 참고하시기 바랍니다.

코드예제Action Block Sample Code

{
    "type": "action",
    "elements": [
        {
            "type": "button",
            "text": "승인",
            "style": "primary"
        },
        {
            "type": "button",
            "text": "반려",
            "style": "default"
        }
    ]
}

이 문서가 만족스러운 이유를 알려주세요.
이 문서에 아쉬운 점을 알려주세요.
평가해주셔서 감사합니다.

더 자세한 의견은 documentation@kakaoenterprise.com 으로 제보해주세요.