목차
urlize() 예제 - 텍스트 URL을 클릭 가능한 링크로 변환 urlize() 정의 urlize() 구문
urlize() 예제 - 텍스트 URL을 클릭 가능한 링크로 변환
[예제1] - 매개변수 없이 가장 간단한 링크로 변환
{% set str = "홈짱닷컴 https://homzzang.com" %}
{{ str|urlize }}
결과값: 홈짱닷컴 <a href="https://homzzang.com" rel="noopener">https://homzzang.com</a>
[예제2] - 링크 표시 문자열 길이 자르기
{% set str = "홈짱닷컴 https://homzzang.com/b/jinja-114?sca=filters&page=3" %}
{{ str|urlize(trim_url_limit=20) }}
결과값: 홈짱닷컴 <a href="https://homzzang.com/b/jinja-114?sca=filters&page=3" rel="noopener">https://homzzang.com...</a>
[예제3] - rel="nofollow"와 target="_blank" 속성 추가
{% set str = "홈짱닷컴 https://homzzang.com" %}
{{ str|urlize(nofollow=True, target="_blank") }}
결과값: 홈짱닷컴 <a href="https://homzzang.com" rel="nofollow noopener" target="_blank">https://homzzang.com</a>
[예제4] - 링크 변환 허용할 추가 스키마 지정
{% set str = "공유 폴더 ftp://homzzang.com/shared" %}
{{ str|urlize(extra_schemes=["ftp://"]) }}
결과값: 공유 폴더 <a href="ftp://example.com/shared" rel="noopener">ftp://example.com/shared</a>
urlize() 정의
텍스트 URL을 클릭 가능한 링크 태그로 변환 적용하는 필터 .
1.
일부 상황에서는 이 필터가 링크를 인식하지 못할 수 있음 . 일반적으로는 Markdown 라이브러리와 같은 더 포괄적인 포맷터를 사용하는 것이 더 나은 선택임.이 필터는 http://, https://, www., mailto:, 그리고 이메일 주소에서 작동함 . 링크 뒤에 구두점(마침표, 쉼표, 닫는 괄호)이 있거나 앞에 구두점(여는 괄호)이 있는 경우, 해당 구두점을 제외하고 링크를 인식함. 헤더 필드를 포함하는 이메일 주소는 인식되지 않음. (예: mailto:?cc=).
2.
Jinja2 2.8 - target 매개변수가 추가됨.
Jinja2 3.0 - extra_schemes 매개변수가 추가됨.
Jinja2 3.0 - 스키마 없는 URL에 대해 https:// 링크를 생성.
Jinja2 3.0 - 구문 분석 규칙이 업데이트됨. mailto: 스키마를 사용하거나 사용하지 않는 이메일 주소를 인식함. IP 주소를 유효성 검사함. 더 많은 경우에 괄호와 대괄호를 무시함.
3. 공식 매뉴얼
https://jinja.palletsprojects.com/en/3.1.x/templates/#jinja-filters.urlize
urlize() 구문
jinja-filters.urlize(value: str, trim_url_limit: int | None = None, nofollow: bool = False, target: str | None = None, rel: str | None = None, extra_schemes: Iterable[str] | None = None ) → str
[매개변수]
value: str
필수. 링크 추가할 원본 텍스트.trim_url_limit: int | None = None nofollow: bool = False
선택. 링크에 rel=nofollow 속성을 추가할지 여부.
target: str | None = None
선택. 링크에 target 속성 추가.
rel: str | None = None
선택. 링크에 rel 속성 추가.
extra_schemes: Iterable[str] | None = None
선택. 링크 변환 대상으로 인식할 추가 스키마 지정.
기본 동작 외에 이러한 스키마로 시작하는 URL을 인식함. 추가 스키마가 없으면 기본값으로 설정됨.
기본값은 env.policies["urlize.extra_schemes"]이며, 추가 스키마 없음 의미.
[반환값]
링크 태그로 변환 적용된 문자열 반환.
