Grav — Twig Фильтры и функции

В этой главе давайте изучим фильтры и функции веток . Фильтры используются для форматирования данных так, как вы хотите, с требуемым выводом. Функции используются для генерации содержимого.

Шаблоны Twig — это текстовые файлы, которые содержат выражения и переменные, замененные значениями. Twig использует три типа тегов.

• Выходные теги — следующий синтаксис используется для отображения здесь результата оцененных выражений.

Выходные теги — следующий синтаксис используется для отображения здесь результата оцененных выражений.

{{  Place Your Output Here  }}

• Теги действий — следующий синтаксис используется для выполнения операторов здесь.

Теги действий — следующий синтаксис используется для выполнения операторов здесь.

{%  executable statements are placed here  %}

• Теги комментариев — следующий синтаксис используется для записи комментариев в файл шаблона Twig.

Теги комментариев — следующий синтаксис используется для записи комментариев в файл шаблона Twig.

{#  write your comment here  #}

Twig Filters

Twig Filters использует | символ для применения фильтров к переменной Twig, за которым следует имя фильтра. Аргументы могут быть переданы в скобках аналогично функциям Twig.

В следующей таблице показаны фильтры Twig, используемые в Grav —

'<img src="/some/path/img.jpg"/>' |absolute_url

<img src="http://learn.getGrav.org/some/path/img.jpg" />

'contact_us'| camelize

ContactUs

'This is some string' | contains('some')

1

set header_image_width = 
page.header.header_image_width|defined(900)

'this is an example for ends-with filter' | ends_with('filter')

True

'field.name'|fieldName

field[name]

'some_text_to_read'|humanize

Some text to read

{% set ritems = {'orange':1, 'apple':2, 'peach':3}|ksort %}
{% for key, value in ritems %}{{ key }}:{{ value }}, {% endfor %}

apple:2, orange:1, peach:3,

'/strip/leading/slash/'|ltrim('/')

strip/leading/slash/

'## some text with markdown'|markdown

some text with markdown

'something'|md5

437b930db84b8079c2dd804a71936b5f

'61'|monthize

2

page.date|nicetime(false)

3 hrs ago

'78'| ordinalize

78th

'child'|pluralize

children

{% 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,

'/strip/leading/slash/'|rtrim('/')

/strip/leading/slash

'vehicles'|singularize

vehicle

"[email protected]"|safe_email

someoneemailaddress@domain.com

{% 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 %}

melw@fdd.com:1, john@gmail.com:3, nancy@fb.com:7,

'this is an example for starts-with filter' |starts_with('this')

true

MY_LANGUAGE_KEY_STRING

'Some text in English'

'welcome page'|titleize

Welcome Page

'ContactUs'|underscorize

contact_us

'one sentence. two sentences'|truncate(5)

one s...

'one sentence. two sentences'|truncate(5, true)

one sentence

'<p>one <strong>sentence<strong>. two sentences</p>'|striptags|truncate(5)

one s

Абсолютный URL

Он берет относительный путь и преобразует его в абсолютный URL.

преобразует в —

Camelize

Он преобразует строку в формат CamelCase.

преобразует в —

Содержит

если он находит строку.

выход —

определенный

Вы можете проверить, определена ли некоторая переменная или нет. Если переменная не определена, вы можете указать значение по умолчанию.

Устанавливает header_image_width со значением 900, если оно не определено.

Завершает-С

Вы можете определить, заканчивается ли строка данной строкой, используя фильтр Ends-With.

отображается как —

FieldName

Он фильтрует имя поля, изменяя точку в нотацию массива.

отображается как —

смягчать

Он используется для преобразования строки в читаемый человеком формат.

отображается как —

Ksort

Сортирует карту массива по ключу.

отображается как —

Левая отделка

Он используется для удаления пробелов в начале строки и удаляет совпадающий символ, заданный с левой стороны строки.

отображается как —

уценка

Он используется для преобразования строки, содержащей разметку, в HTML с помощью анализатора разметки Grav.

отображается как —

MD5

Хэш md5 для строки может быть создан с помощью этого фильтра.

отображается как —

Monthize

Используя фильтр Monthize, мы можем преобразовать целое число дней в количество месяцев.

отображается как —

Прекрасное время

Используя фильтр Nice Time, мы можем получить дату в удобном для человека формате времени в качестве вывода.

отображается как —

Ordinalize

Порядковые числа (например, 1- ^й , 2- ^й , 3- ^й ) могут быть переданы целым числам с помощью фильтра Ordinalize.

отображается как —

образовывать множественное число

Строка может быть преобразована во множественную английскую форму с помощью фильтра Pluralize.

отображается как —

Перемешайте

Этот фильтр помогает рандомизировать предоставленный список. Если параметр содержит какие-либо значения, то эти значения исключаются из рандомизации.

отображается как —

Правая отделка

Он очень похож на левую обрезку, за исключением того, что удаляет пробелы и соответствующий символ с правой стороны строки.

отображается как —

образовывать форму единственного числа

Строка может быть преобразована в английскую единственную версию с помощью фильтра Singular.

отображается как —

Безопасная электронная почта

Безопасный фильтр электронной почты используется для преобразования адреса электронной почты в символы ASCII, что затрудняет спам в письме.

выход —

SortByKey

Используется для сортировки карты массива по ключам.

это отображает —

Начинается с

Вы можете определить, начинается ли строка с данной строки, используя фильтр Starts-With.

выход —

Переведите

для более подробной информации.

это отображает —

Перевести админа

Он переводит строку на текущий язык, который установлен в файле user.yaml .

Titleize

Строка преобразуется в формат Case Title с помощью Titleize.

это отображается как —

UnderScoreize

формат с использованием фильтра UnderScoreize.

он преобразуется в —

Обрезать строку

Вы можете использовать усечение, чтобы усечь строку или сократить строку, вы должны указать количество символов.

оно усекается до —

Вы можете использовать true в качестве параметра, если не хотите обрезать строку до ближайшего конца предложения после заданного количества символов.

оно усекается до —

это отображается как —

Функции веток

Функции веток напрямую вызываются путем передачи параметра. В следующей таблице перечислены функции —

массив

Эта функция приводит значение к массиву.

санкционировать

Эта функция делает авторизованного пользователя авторизованным для просмотра ресурса и принимает строку разрешения или массив строк разрешения.

свалка

Он принимает допустимую переменную ветки и выводит ее на панель отладчика Grav. Тем не менее, отладчик должен быть включен, чтобы увидеть значения вкладки сообщения.

отлаживать

Это работает так же, как функция dump ().

Суть

Эта функция создает код встраивания Gist на основе идентификатора Gistub Gist.

Генерация случайных строк

Эта функция создаст случайную строку с указанным количеством символов. Эти строки можно использовать как уникальный идентификатор или ключ.

Повторение

Эта функция будет повторять строку в течение заданного промежутка времени.

строка

Создает случайную строку указанной длины символа.

Перевести массив

Это функция, связанная с | та фильтром.

Веб — сайт

Этот фильтр создаст URL, а также преобразует потоки URL PHP в действительные ресурсы HTML. Если URL не может быть разрешен, может быть передано значение по умолчанию.

Переведите

Используя фильтр Translate, строка переводится как | t фильтр.

переводится на —