break

for 반복문 내부에서 특정 조건을 만족했을 때 루프 순회를 즉시 중단하고 빠져나오는 제어문입니다.

문법

{% for item in array %} {% if condition %} {% break %} {% endif %} ... {% endfor %}

예시

{% assign numbers = "1,2,3,4,5" | split: "," %}{% for n in numbers %}{% if n == "3" %}{% break %}{% endif %}{{ n }}{% endfor %}

결과

12

break 태그는 for 루프를 실행하던 도중 특정 조건이 충족되면 남은 순회를 모두 건너뛰고 반복문을 즉각 탈출하도록 만드는 루프 제어문입니다. 일반적으로 if 조건문과 함께 루프 블록 내부에 배치하여 탐색 중단이나 최대 출력 개수 도달 시점을 제어하는 데 활용됩니다.

키워드 조합 페이지에서는 키워드 행의 연관 추천 목록(page.related)이나 속성 태그 중 상위 몇 가지만 선별하여 노출하고자 할 때 유용합니다. 예를 들어 {% for sibling in page.related %}{% if forloop.index > 3 %}{% break %}{% endif %}<a href="{{ sibling.path }}">{{ sibling.title }}</a>{% endfor %}와 같이 구성하면 최대 3개의 관련 지역 링크만 깔끔하게 노출하고 루프를 안전하게 조기 종료할 수 있습니다.

이 문법을 편집기에서 바로 써 보세요.