본문으로 건너뛰기
목차 · 문서 쓰기

템플릿 반복과 조건

템플릿에 반복 태그를 쓰면 표의 행이나 목록 줄을 항목 수만큼 만듭니다. 조건 태그를 쓰면 값이 있을 때만 절을 넣습니다. 토큰의 기본 규칙은 템플릿과 스니펫을 봅니다.

예제 템플릿으로 해 보기

기본 템플릿과 스니펫 중 아래 항목이 반복과 조건을 씁니다.

이름 종류·그룹 반복과 조건
견적서 템플릿·회의·보고 품목 표의 행, 비고가 있을 때만 비고 절
회의 결과 요약 템플릿·회의·보고 참석자를 쉼표로 잇기, 안건 표의 행, 할 일 체크 상자, 다음 회의 절
출장 신청서 템플릿·회의·보고 일정 표의 행, 동행자 목록, 비고 절
체크리스트 템플릿·개인 항목마다 체크 상자 한 줄, 마감 줄
할 일 목록 (담당·기한) 스니펫·회의·보고 할 일마다 체크 상자 한 줄
붙여 넣은 행으로 표 스니펫·표 붙여 넣은 행마다 표의 행
  1. 파일 > 템플릿으로 새 문서(Ctrl+Shift+N)를 클릭합니다.
  2. 찾기 칸에 견적서 를 입력하고 [만들기] 버튼을 클릭합니다. 「템플릿 값 입력」 창이 뜹니다.
  3. 품목 입력란에 키보드 | 2 | 15,000 | 30,000 을 입력하고 Enter 를 누릅니다.
  4. 다음 줄에 마우스 | 1 | 10,000 | 10,000 을 입력합니다.
  5. [확인] 버튼을 클릭합니다.

새 문서의 품목 표에 두 행이 생기고 번호가 1, 2 로 매겨집니다. 비고 입력란을 비웠으면 비고 절은 빠집니다.

템플릿 값 입력 창의 여러 줄 입력란에 항목을 한 줄씩 넣은 모습

반복 값 입력하기

반복 블록의 입력란은 여러 줄입니다. 입력란 위에 필드 차례(견적서는 이름 | 수량 | 단가 | 금액)가 보입니다.

  • 한 줄에 항목 하나를 입력합니다. Enter 는 줄바꿈입니다.
  • 필드는 탭이나 |로 나눕니다. 엑셀에서 같은 차례의 셀을 복사해 붙여 넣어도 됩니다.
  • 필드가 모자란 줄은 남은 필드가 빈 값입니다. 남는 칸은 마지막 필드에 붙습니다.
  • | 마우스 | 1 |처럼 앞뒤의 |는 무시합니다. 빈 줄은 건너뜁니다.
  • 필드가 없는 반복(참석자처럼 이름만)은 「한 줄에 한 항목」이라고 보입니다.
  • 조건 블록의 입력란은 비우면 거짓이고, 무엇이든 입력하면 참입니다.

표의 행 되풀이하기

{{#each 이름}} 과 {{/each}} 사이를 항목마다 되풀이합니다. 태그만 있는 줄은 줄째 빠지므로 표 행 사이에 빈 줄이 생기지 않습니다.

| 번호 | 품목 | 수량 | 금액 |
| ---: | ---- | ---: | ---: |
{{#each 품목}}
| {{@번호}} | {{이름}} | {{수량}} | {{금액}} |
{{/each}}
  • 안쪽의 {{이름}} 같은 토큰이 그 항목의 필드입니다. 입력란에서는 처음 나온 차례대로 필드를 나눕니다.
  • {{@번호}}는 1부터 세는 번호입니다.
  • 항목이 없으면 행이 없는 표가 됩니다. 대신 넣을 글이 있으면 {{else}} 뒤에 씁니다.

목록과 문장 안에서 되풀이하기

필드 없이 줄만 넣는 반복은 {{this}}로 그 항목을 씁니다.

{{#each 항목}}
- [ ] {{this}}
{{/each}}

참석: {{#each 참석자}}{{this}}{{#unless @last}}, {{/unless}}{{else}}(적지 않음){{/each}}

첫 블록은 항목마다 체크 상자 한 줄을 만듭니다. 둘째 줄은 참석자를 쉼표로 잇고 마지막 사람 뒤에는 쉼표를 넣지 않습니다. 참석자가 없으면 (적지 않음)이 들어갑니다.

값이 있을 때만 넣기

{{#if 비고}}
## 비고

{{비고}}
{{else}}
비고 없음
{{/if}}

값이 있으면 {{else}} 앞을, 없으면 뒤를 넣습니다. {{else}}는 없어도 됩니다. {{#unless 이름}}은 값이 없을 때만 넣습니다. {{#if 이메일}}처럼 기본 토큰도 조건에 쓸 수 있습니다.

태그 표

태그 뜻
{{#each 이름}} … {{/each}} 항목마다 안쪽을 되풀이합니다. 항목이 없으면 {{else}} 뒤를 넣습니다
{{#if 이름}} … {{else}} … {{/if}} 값이 있으면 앞쪽, 없으면 {{else}} 뒤를 넣습니다. {{else}}는 없어도 됩니다
{{#unless 이름}} … {{/unless}} 값이 없을 때만 넣습니다
{{필드}} 반복 안에서 그 항목의 필드 값. 항목에 없으면 바깥 값이고, 둘 다 없으면 빈 값입니다
{{this}} 반복 안에서 항목 자체(필드 없이 줄만 넣은 목록)
{{@번호}} {{@number}} 1부터 세는 항목 번호. {{@index}}는 0부터입니다
@first @last 조건에 씁니다. 첫 항목, 마지막 항목이면 참입니다
  • 공백만 있는 값, 빈 목록, 넣지 않은 값은 거짓입니다. 반복은 0번 됩니다.
  • 태그만 있는 줄은 줄째 빠집니다. 표 행 사이에 빈 줄이 생기지 않습니다.
  • 반복은 두 겹, 블록은 네 겹까지 겹칠 수 있습니다. 항목은 500개까지입니다.
  • 짝이 맞지 않는 태그는 그대로 두고 줄 번호를 알립니다. 코드 블록 안의 태그는 바꾸지 않습니다.
  • 계산은 하지 않습니다. 합계 같은 값은 따로 입력합니다.

막힐 때

  • 「짝이 맞지 않는 블록 태그는 그대로 두었습니다」 알림이 뜨면 알림의 줄 번호에서 {{#each}}·{{#if}} 마다 닫는 태그가 있는지 봅니다. 닫는 태그는 여는 태그와 종류가 같아야 합니다.
  • 필드 칸이 한 칸씩 밀리면 입력란 위의 필드 차례와 줄의 칸 수를 맞춥니다. 엑셀에서 붙여 넣을 때는 열 차례를 맞춥니다.
  • 필드 이름으로 날짜·작성자 같은 기본 토큰 이름은 쓰지 않습니다. 반복 안에서도 오늘 날짜·작성자가 들어갑니다.
  • 편집기의 자동 완성(Ctrl+Space)으로 넣은 스니펫은 값을 묻지 않으므로 태그가 그대로 남습니다. 서식 > 스니펫(Ctrl+Shift+A)으로 넣습니다.

관련 페이지