> For the complete documentation index, see [llms.txt](https://happytalk.gitbook.io/happybot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://happytalk.gitbook.io/happybot/block_scenario/block/single/list.md).

# \[단일] 리스트 카드

***

##  1. ![](/files/M2W2amwchAH6slk07hjY) '리스트'카드 란?

{% hint style="success" %} <mark style="color:green;">**최대 5개까지 리스트 형식으로 여러가지 상품을 보여주는 메시지 카드**</mark>입니다.<br>

버튼을 가로로 2개까지 설정할 수 있고, \
버튼 개수에 따라 노출되는 버튼의 글자수가 달라집니다.\
\
이 리스트 카드를 슬라이드 형태로 여러개 제공하고 싶다면.\
\[슬라이드]  리스트 카드를 사용하시면 됩니다.<br>

[\[슬라이드\] 리스트 카드](/happybot/block_scenario/block/slide/list.md)
{% endhint %}

<figure><img src="/files/6lVa3OE31c1RhRTxPAd7" alt=""><figcaption></figcaption></figure>

***

## 2. 블럭의 형태 및 사용 방법

<figure><img src="/files/YjPCkZvGXLXq0giD3JdW" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %} <mark style="color:red;">**주의 사항**</mark>

* 모든 글자 수는 띄어쓰기가 포함되며, 한글/영문/숫자/공백 모두 한 글자로 취급합니다.
* 버튼명의 경우 카카오는 최대 14자만 노출됩니다.
* 이미지 업로드 시 1MB 미만의 JPG, PNG만 지원됩니다.
  {% endhint %}

<table><thead><tr><th width="80">No</th><th width="178">구분</th><th width="71">필수</th><th>설명</th></tr></thead><tbody><tr><td>①</td><td>블럭 타이틀</td><td>X</td><td><ul><li>40자 이하 입력/수정 가능 </li><li>생성 시 “<em>리스트 카드 {No}</em>” 형태로 생성 됨</li></ul></td></tr><tr><td>②</td><td>대표문구</td><td>O</td><td><ul><li>15자 이하 입력/수정 가능</li><li>대표문구에 URL 연결 가능</li></ul></td></tr><tr><td>③</td><td>리스트 타이틀</td><td>O</td><td><ul><li>35자 이하 입력/수정 가능</li></ul></td></tr><tr><td>④</td><td>내용</td><td>X</td><td><ul><li>16자 이하 입력/수정 가능</li></ul></td></tr><tr><td>⑤</td><td>썸네일 이미지</td><td>X</td><td><ul><li>300* 300 사이즈 권장</li><li>1MB(1,000KB) 미만의 이미지 파일(JPG, PNG)만 지원</li></ul></td></tr><tr><td>⑥</td><td>리스트 추가</td><td>X</td><td><ul><li>최대 5개까지 리스트 생성 가능</li></ul></td></tr><tr><td>⑦</td><td>버튼</td><td>O</td><td><ul><li>최소 1개(필수) ~ 최대 2개까지만 설정 가능</li><li>50자 이하 입력/수정은 가능하지만 등록 후 실제 채널에서 버튼이 1개일 경우는 1줄에 최대 14자, 버튼이 2개일 경우는 2줄에 최대 6자만 노출됨</li><li>버튼 기능에 따라 블록 연결 버튼 노출/미노출 처리됨</li></ul></td></tr><tr><td>⑧</td><td>서브 블럭 연결 버튼</td><td>O</td><td><ul><li>해당 블럭과 연결될 블럭을 블럭 편집 창 or 마우스 Drag&#x26;Drop으로 연결 가능</li></ul></td></tr><tr><td>⑨</td><td>블럭 간략 설정 버튼</td><td>-</td><td><ul><li>클릭 시 아래 액션이 가능한 버튼 레이어 노출 <br>a. 미리보기 <br>b. 복제하기 <br>c. 내용접기 <br>d. 블럭 저장 <br>e. 블럭 삭제</li></ul></td></tr><tr><td>그외</td><td>블럭 적용 URL</td><td>X</td><td><ul><li>블럭에 적용될 링크 등록 가능</li></ul></td></tr></tbody></table>

***

## 3. 제공되는  버튼 기능

{% hint style="success" %} <mark style="color:green;">**리스트 카드에서 지원 가능한 버튼의 기능은 총 9가지 입니다.**</mark>

버튼에 변수 부여를 위한 파라미터 설정이 가능하며,

버튼 파라미터 부여 방법은 버튼 파라미터 설정에서 확인 가능하실 수 있습니다.<br>

[변수/파라미터 설정](/happybot/block_scenario/parameter.md)
{% endhint %}

![](/files/98VnNfwDQNF1m01Xv8W5)

<table><thead><tr><th width="240">버튼 기능</th><th>설명</th><th data-hidden></th></tr></thead><tbody><tr><td><strong>메시지 연결</strong></td><td>다른 메시지 카드로 연결함</td><td></td></tr><tr><td><strong>시나리오 연결</strong></td><td>다른 시나리오의 시작점으로 연결함</td><td></td></tr><tr><td><strong>URL 링크</strong></td><td><p>입력한 URL 주소를 새창으로 연결함</p><p>(URL은 http:// 또는 https://로 시작되도록 입력)</p></td><td></td></tr><tr><td><strong>전화</strong></td><td>입력한 전화번호로 전화걸기(모바일에서만 가능)</td><td></td></tr><tr><td><strong>조건 버튼</strong></td><td>미리 조건을 설정하여 True/False에 따라 다른 버튼을 연결함<br>(True/False에 각각 연결하는 버튼은 나머지 8가지 중 선택 가능)</td><td></td></tr><tr><td><strong>다른 서비스 호출</strong></td><td>외부 연결 메시지 등록</td><td></td></tr><tr><td><strong>공유하기</strong></td><td>친구에게 공유하기</td><td></td></tr><tr><td><strong>채널 추가</strong></td><td>카카오톡 채널 추가하기</td><td></td></tr><tr><td><strong>오픈빌더 플러그인 실행</strong></td><td>오픈빌더 플러그인 실행</td><td></td></tr></tbody></table>