[filters] Jinja - wordwrap() 필터 - 문자열을 지정 길이 단위로 쪼개기 (= wordwrap필터 = 워드랩필터) ※ 문자열을 지정 너비 단위로 묶기/감싸기

1. wordwrap() 예제 - 문자열을 지정 너비에서 줄바꿈 시키기
2. wordwrap() 정의
3. wordwrap() 구문

wordwrap() 예제 - 문자열을 지정 너비에서 줄바꿈 시키기

[예제1] - 너비 10 씩 묶기

 

{% set str = "홈짱닷컴 Homzzang.com HTMLCSSJAVASCRIPTJQUERYPHPSQL" %}

{{ str|wordwrap(10) }}

 

결과값: 홈짱닷컴 Homzz ang.com HT MLCSSJAVAS CRIPTJQUER YPHPSQL

---

[예제2] - 긴 단어 경우 안 쪼개기

 

{% set str = "홈짱닷컴 Homzzang.com HTMLCSSJAVASCRIPTJQUERYPHPSQL" %}

{{ str|wordwrap(10, break_long_words=False) }}

 

결과값: 홈짱닷컴 Homzzang.com HTMLCSSJAVASCRIPTJQUERYPHPSQL

---

[예제3] - 래핑된 단어들을 언바로( _ )로 연결

 

{% set str = "CSSPHPSQL" %} 

{{ str|wordwrap(3,wrapstring="_") }}

결과값: CSS_PHP_SQL

---

[예제4] - 하이픈 포함 단어 경우

 

{% set str = "홈짱닷컴 Homzzang.com HTML-CSS-JAVASCRIPT-JQUERY-PHP-SQL" %}

{{ str|wordwrap(10, break_on_hyphens=False) }}

 

결과값: 홈짱닷컴 Homzz ang.com HT ML-CSS-JAV ASCRIPT-JQ UERY-PHP-S QL 

wordwrap() 정의

 

문자열을 지정 너비 단위로 묶는 필터.

 

---

 

1.

• 기존 개행 문자는 별도로 래핑되는 단락으로 처리됨.
• 긴 문자열을 지정 길이 단위로 특수문자로 구분지을 때 유용.

 

2.

• Jinja2 2.7 - wrapstring 매개변수가 추가됨.
• Jinja2 2.11 - 기존의 새 줄은 별도로 줄바꿈해야 할 단락으로 취급됨.
• Jinja2 2.11 - break_on_hyphens 매개변수가 추가됨.

 

3. 공식 매뉴얼

https://jinja.palletsprojects.com/en/3.1.x/templates/#jinja-filters.wordwrap

 

wordwrap() 구문

 

jinja-filters.wordwrap(s: str, width: int = 79, break_long_words: bool = True, wrapstring: str | None = None, break_on_hyphens: bool = True) → str

 

---

[매개변수]

 

s: str

필수. 이 필터를 적용할 문자열.

 

width: int = 79

선택. 래핑 너비.

 

break_long_words: bool = True

선택. 단어 길이가 width보다 큰 경우, 여러 줄로 나눌지 여부 지정.

 

wrapstring: str | None = None

선택. 래핑된 문자열을 연결할 문자열. 

• 기본값: Environment.newline_sequence (공백으로 구분됨.)
• 만약, wrapstring="_" 지정 시,  "_" 문자로 연결됨.

 

break_on_hyphens: bool = True

선택. 단어에 하이픈(-) 포함된 경우, 여러 줄로 나눌지 여부 지정.