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

페이지 이동경로

Text Block

Text Block(텍스트 블록)은 말풍선에서 가장 기본인 텍스트를 표현하는 블록입니다. Text Block은 단독으로도 존재할 수 있지만, 레이아웃 블록을 구성하는 엘리먼트의 속성으로 사용되기도 합니다.

Text Block
블록 유형 블록명 엘리먼트 레이아웃 블록
말풍선 Text Block O X

기능 소개

Text Block은 다음의 기능을 지원합니다.

카카오워크 1.7 버전 이후부터 Text Block의 표준 포맷이 Markdown에서 다음과 같이 변경되었습니다.

  • Plain Text 또는 Styled Text 포맷으로 내용 입력 가능
  • Plain Text와 Styled Text 모두 줄넘김(\n) 기능 지원
Text Block 구성
블록 포맷 설명
Text Block Plain Text 글자 수: 최대 500자(공백 및 줄바꿈 포함)
Inlines 글자 수: 최대 500자(공백 및 줄바꿈 포함)
Bold: 굵게 표시
Strike: 취소선
Italic: 기울임
Color: 색상
Link: 링크

Plain Text

Plain Text(플레인 텍스트)는 별도의 서식 없이 단순 텍스트로만 구성된 Text Block 포맷으로, 텍스트만 입력하여 메시지를 구성할 때 활용합니다.

그림Plain Text 블록 예시

주의
Plain Text로 Text Block을 구성한 경우, 별도의 링크 자동 변환 기능은 지원하지 않습니다.

Inlines

Inlines(인라인스)는 텍스트에 다양한 추가 서식을 적용할 때 사용하는 Text Block 포맷입니다.

안내
폰트 종류와 크기 설정 기능은 지원하지 않습니다.

Inlines Format 그림Inlines(Styled와 Link 속성)를 적용한 Text Block 예시

Inlines 속성
파라미터 타입 필수 여부 설명
type String 필수 다음의 속성으로 구성
styled: Bold, Strike, Italic, Color 등의 스타일 속성
link: 링크 속성
text String 필수 스타일 또는 링크를 적용할 텍스트
bold Boolean 선택 굵은 글씨체
true: 굵은 글씨체 적용
false(기본값): 굵은 글씨체 미적용
italic Boolean 선택 기울어진 글씨체
true: 기울기 글씨체 적용
false(기본값): 기울기 글씨체 미적용
strike Boolean 선택 취소선
true: 취소선 적용
false(기본값): 취소선 미적용
color String 선택 글자 색상
default(기본값): 검정색
grey: 회색
blue: 파란색
red: 빨간색
url String 선택 연결할 링크 주소
- link 속성을 사용 시 필수로 지정

Styled

Styled 속성은 Text Block에 Bold, Italic, Strike, Color의 스타일을 지정하여 텍스트를 꾸밀 수 있습니다. Styled 속성을 적용했을 시에는 Bold, Italic, Strike, Color를 중복하여 사용할 수 있으며, 값을 명시하지 않은 경우 기본값이 적용됩니다.

코드예제Styled 속성 적용 예시

{
    "type": "text",
    "text": "카카오워크 텍스트 블록 변경",
    "inlines": [
        {
            "type": "styled",
            "text": "카카오워크 "
        },
        {
            "type": "styled",
            "text": "텍스트",
            "bold": true
        },
        {
            "type": "styled",
            "text": " 블록 변경",
            "color": "red"
        }
    ]
}

Link는 Text Block에 HTTP 또는 HTTPS Scheme을 적용할 수 있는 속성입니다.

주의
URL 링크에는 Bold, Italic, Strike, Color를 적용할 수 없습니다.

코드예제Link 속성 적용 예시

{
    "type": "text",
    "text": "카카오워크 기술문서",
    "inlines": [
        {
            "type": "link",
            "text": "카카오워크 기술 문서",
            "url": "https://blog.kakaowork.com/43"
        }
    ]
}

블록 속성

블록 속성
속성 타입 필수 여부 설명
type String 필수 타입 고정값
- text로 고정
text String 필수 관련 내용
Array 선택 텍스트에 스타일을 적용할 때 사용
type String 필수 다음의 속성으로 구성
styled: Bold, Strike, Italic, Color 등의 스타일 속성
link: 링크 속성
text String 필수 스타일 또는 링크를 적용할 텍스트
bold Boolean 선택 굵은 글씨체
true: 굵은 글씨체 적용
false(기본값): 굵은 글씨체 미적용
italic Boolean 선택 기울어진 글씨체
true: 기울기 글씨체 적용
false(기본값): 기울기 글씨체 미적용
strike Boolean 선택 취소선
true: 취소선 적용
false(기본값): 취소선 미적용
color String 선택 글자 색상
default(기본값): 검정색
red: 빨간색
blue: 파란색
grey: 회색
url String 선택 연결할 링크 주소
- link 속성을 사용 시 필수로 지정

코드예제Text Block Sample Code

{
    "type": "text",
    "text": "카카오워크 텍스트 블록이 변경되었습니다. 자세한 내용은 기술 문서를 참고하시기 바랍니다.",
    "inlines": [
        {
            "type": "styled",
            "text": "카카오워크 "
        },
        {
            "type": "styled",
            "text": "텍스트",
            "bold": true,
            "color": "red"
        },
        {
            "type": "styled",
            "text": " 블록이 변경되었습니다. 자세한 내용은 "
        },
        {
            "type": "link",
            "text": "기술 문서",
            "url": "https://blog.kakaowork.com/43"
        },
        {
            "type": "styled",
            "text": "를 참고하시기 바랍니다."
        }
    ]
}

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

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