Grav-Twig 필터 및 기능

이 장에서는 Twig Filters and Functions. 필터는 필요한 출력과 함께 원하는 방식으로 데이터를 형식화하는 데 사용됩니다. 콘텐츠를 생성하는 데 함수가 사용됩니다.

Twig 템플릿은 값으로 대체 된 표현식과 변수를 포함하는 텍스트 파일입니다. Twig는 세 가지 유형의 태그를 사용합니다.

Output tags − 여기에 평가 된 표현식 결과를 표시하기 위해 다음 구문이 사용됩니다.

{{  Place Your Output Here  }}

Action Tags − 여기서 문을 실행하기 위해 다음 구문이 사용됩니다.

{%  executable statements are placed here  %}

Comment tags − Twig 템플릿 파일에 주석을 작성하기 위해 다음 구문이 사용됩니다.

{#  write your comment here  #}

나뭇 가지 필터

Twig Filters는 |문자를 사용하여 Twig 변수에 필터를 적용한 다음 필터 이름을 입력합니다. Twig 함수와 유사하게 인수를 괄호 안에 전달할 수 있습니다.

다음 표는 Grav에서 사용되는 Twig Filter를 보여줍니다.


'<img src="/some/path/img.jpg"/>' |absolute_url
'contact_us'| camelize
'This is some string' | contains('some')
set header_image_width = 
page.header.header_image_width|defined(900)
'this is an example for ends-with filter' | ends_with('filter')
'field.name'|fieldName
'some_text_to_read'|humanize
{% set ritems = {'orange':1, 'apple':2, 'peach':3}|ksort %}
{% for key, value in ritems %}{{ key }}:{{ value }}, {% endfor %}
'/strip/leading/slash/'|ltrim('/')
'## some text with markdown'|markdown
'something'|md5
'61'|monthize
page.date|nicetime(false)
'78'| ordinalize
'child'|pluralize
{% set ritems = ['one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'ten']|randomize(3) %}
{% for ritem in ritems %}{{ ritem }}, {% endfor %}
'/strip/leading/slash/'|rtrim('/')
'vehicles'|singularize
"[email protected]"|safe_email
{% set people = [{'email':'[email protected]', 'id':3}, {'email':'[email protected]', 'id':1}, {'email':'[email protected]', 'id':7}]|sort_by_key('id') %}
{% for person in people %}{{ person.email }}:{{ person.id }}, {% endfor %}
'this is an example for starts-with filter' |starts_with('this')
MY_LANGUAGE_KEY_STRING

'welcome page'|titleize
'ContactUs'|underscorize
'one sentence. two sentences'|truncate(5)

Sr. 아니.	필터 및 설명	예
1	Absolute URL 상대 경로를 가져와 절대 URL로 변환합니다.	`'<img src="/some/path/img.jpg"/>' \|absolute_url` -로 변환 `<img src="http://learn.getGrav.org/some/path/img.jpg" />`
2	Camelize 문자열을 CamelCase 형식으로 변환합니다.	`'contact_us'\| camelize` -로 변환 `ContactUs`
삼	Contains 문자열을 찾으면.	`'This is some string' \| contains('some')` 출력은- `1`
4	Defined 일부 변수가 정의되어 있는지 확인할 수 있습니다. 변수가 정의되지 않은 경우 기본값을 제공 할 수 있습니다.	`set header_image_width = page.header.header_image_width\|defined(900)` 그것은 설정 header_image_width 정의되지 않은 경우 값 900입니다.
5	Ends-With Ends-With 필터를 사용하여 문자열이 주어진 문자열로 끝나는 지 여부를 확인할 수 있습니다.	`'this is an example for ends-with filter' \| ends_with('filter')` 다음과 같이 표시됩니다. `True`
6	FieldName 점을 배열 표기법으로 변경하여 필드 이름을 필터링합니다.	`'field.name'\|fieldName` 다음과 같이 표시됩니다. `field[name]`
7	Humanize 문자열을 사람이 읽을 수있는 형식으로 변환하는 데 사용됩니다.	`'some_text_to_read'\|humanize` 다음과 같이 표시됩니다. `Some text to read`
8	Ksort 키를 사용하여 배열 맵을 정렬합니다.	`{% set ritems = {'orange':1, 'apple':2, 'peach':3}\|ksort %} {% for key, value in ritems %}{{ key }}:{{ value }}, {% endfor %}` 다음과 같이 표시됩니다. `apple:2, orange:1, peach:3,`
9	Left Trim 문자열 시작 부분의 공백을 제거하고 문자열의 왼쪽에서 주어진 일치하는 문자를 제거하는 데 사용됩니다.	`'/strip/leading/slash/'\|ltrim('/')` 다음과 같이 표시됩니다. `strip/leading/slash/`
10	Markdown Grav의 마크 다운 파서를 사용하여 마크 다운이 포함 된 문자열을 HTML로 변환하는 데 사용됩니다.	`'## some text with markdown'\|markdown` 다음과 같이 표시됩니다. `some text with markdown`
11	MD5 이 필터를 사용하여 문자열에 대한 md5 해시를 만들 수 있습니다.	`'something'\|md5` 다음과 같이 표시됩니다. `437b930db84b8079c2dd804a71936b5f`
12	Monthize 월화 필터를 사용하여 정수 일 수를 월 수로 변환 할 수 있습니다.	`'61'\|monthize` 다음과 같이 표시됩니다. `2`
13	Nice Time Nice Time 필터를 사용하면 사람이 읽을 수있는 멋진 시간 형식의 날짜를 출력으로 얻을 수 있습니다.	`page.date\|nicetime(false)` 다음과 같이 표시됩니다. `3 hrs ago`
14	Ordinalize 서수 (예 : ^1st , 2 ^nd , 3 ^rd )는 Ordinalize 필터를 사용하여 정수에 제공 할 수 있습니다.	`'78'\| ordinalize` 다음과 같이 표시됩니다. `78th`
15	Pluralize Pluralize 필터를 사용하여 문자열을 복수 영어 형식으로 변환 할 수 있습니다.	`'child'\|pluralize` 다음과 같이 표시됩니다. `children`
16	Randomize 이 필터는 제공된 목록을 무작위 화하는 데 도움이됩니다. 매개 변수에 값이 포함 된 경우 해당 값은 무작위 화에서 건너 뜁니다.	`{% set ritems = ['one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'ten']\|randomize(3) %} {% for ritem in ritems %}{{ ritem }}, {% endfor %}` 다음과 같이 표시됩니다. `one, two, three, eight, six, five, nine, seven, ten, four,`
17	Right Trim 문자열의 오른쪽에서 공백과 일치하는 문자를 제거한다는 점을 제외하면 왼쪽 트림과 매우 유사합니다.	`'/strip/leading/slash/'\|rtrim('/')` 다음과 같이 표시됩니다. `/strip/leading/slash`
18	Singularize Singular 필터를 사용하여 문자열을 영어 단수 버전으로 변환 할 수 있습니다.	`'vehicles'\|singularize` 다음과 같이 표시됩니다. `vehicle`
19	Safe Email Safe Email 필터는 이메일 주소를 ASCII 문자로 변환하는 데 사용되므로 이메일이 스팸을 받기 어렵습니다.	`"[email protected]"\|safe_email` 출력은- `[email protected]`
20	SortByKey 키를 사용하여 배열 맵을 정렬하는 데 사용됩니다.	`{% set people = [{'email':'[email protected]', 'id':3}, {'email':'[email protected]', 'id':1}, {'email':'[email protected]', 'id':7}]\|sort_by_key('id') %} {% for person in people %}{{ person.email }}:{{ person.id }}, {% endfor %}` 그것은 표시- `[email protected]:1, [email protected]:3, [email protected]:7,`
21	Starts-With Starts-With 필터를 사용하여 문자열이 주어진 문자열로 시작하는지 여부를 확인할 수 있습니다.	`'this is an example for starts-with filter' \|starts_with('this')` 출력은- `true`
22	Translate 자세한 내용은.	`MY_LANGUAGE_KEY_STRING` 그것은 표시- `'Some text in English'`
23	Translate Admin 문자열을 현재 언어로 번역합니다. user.yaml 파일.
24	Titleize 문자열은 Titleize를 사용하여 Title Case 형식으로 변환됩니다.	`'welcome page'\|titleize` 다음과 같이 표시됩니다. `Welcome Page`
25	UnderScoreize UnderScoreize 필터를 사용하여 형식을 지정합니다.	`'ContactUs'\|underscorize` 그것은-로 변환됩니다 `contact_us`
26	Truncate a string Truncate를 사용하여 문자열을 자르거나 문자열을 줄일 수 있습니다. 문자 수를 지정해야합니다.	`'one sentence. two sentences'\|truncate(5)` 그것은- `one s...` 당신이 사용할 수있는 true 주어진 문자 수 뒤에 가장 가까운 문장 끝으로 문자열을 자르지 않으려면 매개 변수로 사용하십시오. `'one sentence. two sentences'\|truncate(5, true)` 그것은- `one sentence` HTML 텍스트를 제거 할 수도 있지만 striptags 전에 필터링 truncate 필터. `'<p>one <strong>sentence<strong>. two sentences</p>'\|striptags\|truncate(5)` 다음과 같이 표시됩니다. `one s`

나뭇 가지 기능

Twig 함수는 매개 변수를 전달하여 직접 호출됩니다. 다음 표는 기능을 나열합니다-

Sr. 아니.	기능 및 설명	예
1	Array 이 함수는 값을 배열로 캐스팅합니다.	`array(value)`
2	Authorize 이 함수는 인증 된 사용자에게 리소스를 볼 수있는 권한을 부여하고 권한 문자열 또는 권한 문자열 배열을 수락합니다.	`authorize(['admin.statistics', 'admin.super'])`
삼	Dump 유효한 나뭇 가지 변수를 받아들이고 Grav 디버거 패널에 덤프합니다. 그러나 메시지 탭 값을 보려면 디버거를 활성화해야합니다.	`dump(page.header)`
4	Debug 이것은 dump () 함수와 동일하게 작동합니다.
5	Gist 이 함수는 Github Gist ID를 기반으로 Gist 임베드 코드를 생성합니다.
6	Random String Generation 이 함수는 지정된 수의 문자로 임의의 문자열을 생성합니다. 이러한 문자열은 고유 ID 또는 키로 사용할 수 있습니다.	`generate_random_string(10)`
7	Repeat 이 함수는 주어진 시간 동안 문자열을 반복합니다.	`repeat('Grav ', 10) will repeat Grav 10 times.`
8	String 지정된 문자 길이의 임의 문자열을 생성합니다.	`ta (23)`
9	Translate Array 연결되는 기능입니다 \|ta 필터.
10	Url 이 필터는 URL을 생성하고 PHP URL 스트림을 유효한 HTML 리소스로 변환합니다. URL을 확인할 수없는 경우 기본값을 전달할 수 있습니다.	`url('theme://images/logo.png') \| default('http://www.placehold.it/150x100/f4f4f4')`
11	Translate 번역 필터를 사용하면 문자열이 \|t 필터.	`t('SITE_NAME')` 로 번역됩니다- `Site Name`