Фильтры шаблонной системы WACT (включая специфичные для Limb фильтры)
WACT Core Filters (Базовые фильтры WACT)
Описание фильтров содержат примеры. Рабочие примеры применения фильтров можно найти в папке limb/wact/examples/filters/core/.
Фильтр | Описание |
Расположение: limb/wact/src/tags/core/ |
capitalize | Враппер для php-функции ucfirst. Приводит первую букву значения переменной в верхний регистр. |
lowercase | Враппер для php-функции strtolower(). Приводит значение переменной в нижний регистр. |
uppercase | Враппер для php-функции strtoupper(). Приводит значение переменной в верхний регистр. |
default | Позволяет указать значение по-умолчанию в выражении для вывода переменной, если значение переменной пусто. |
html | Враппер для php-функции htmlspecialchars(). Обрабатывает значение переменной при помощи этой функции, приводя код к безопасному для просмотра виду. Применяется по-умолчания для всех выражений. |
raw | Выводит значение переменной в неименной виде. Дело в том, что по-умолчанию, значение переменной обрабатывается htmlspecialchars. Если указан DefaultFilter, то такая обработка не производится. |
notags | Враппер для php-функции strip_tags(). Убирает из значения переменной все теги. |
nl2br | Враппер для php-функции nl2br(). Позволяет выводить текст в браузере. Добавляет рядом с символом \n тег <br/>. |
safe_js_text | Заменяет все символы новой строки на <br/>, в отличие от фильтра nl2br, который добавляет к \n тег <br/>. Фильтр safe_js_text обычно используется при формировании JS-кода. |
date | Враппер для php-функции date(). Позволяет форматировать вывод дат. |
number | Враппер для функции number_format(). Позволяет форматировать вывод чисел. |
trim | Враппер для php-функции trim(). Позволяет убирать с конца и с начала строки пробелы или другие символы. |
wordwrap | Враппер для php-функции wordwrap(). Позволяет разбивать предложения на составляющие. Части предложения разделяются знаком «\n». |
url | Враппер для php-функции urlencode(). |
utf8encode | Враппер для php-функции utf8_encode(). |
WACT Data Filters
Фильтр | Описание |
Расположение: limb/wact/src/tags/data/ |
clip | Враппер для php-функции substr(). Позволяет ограничить вывод длинной строки, указывая количество символов, отступ, и символы на границах. |
math | Позволяет производить несложные математически операции прямо в шаблоне. |
stats | Позволяет производить несложные статистические операции прямо в шаблоне. |
Limb I18N Filters (Фильтры для работы с UTF-8 строками)
Фильтры требуют пакета WEB_APP и пакета I18N (он устанавливается автоматически вместе в пакетом WEB_APP).
Фильтр | Описание |
Расположение: limb/wab_app/src/template/tags/i18n/ |
i18n | враппер для глобальной Limb функции tr. Используется для перевода текстовых строк. |
i18n_capitalize | Версия capitalize фильтра, поддерживающего корректно UTF-8 строки. Враппер для функции _ucfirst(), объявленная в пакете I18N. Приводит первую букву значения переменной в верхний регистр. |
i18n_uppercase | Версия uppercase фильтра, поддерживающего корректно UTF-8 строки. Враппер для функции _strtoupper(), объявленной в пакете I18N. Приводит значение переменной в верхний регистр. |
i18n_lowercase | Версия lowercase фильтра, поддерживающего корректно UTF-8 строки. Враппер для функции _strtolower(), объявленной в пакете I18N. Приводит значение переменной в нижний регистр. |
i18n_date | Используется для форматирования вывода локализованных дат. |
i18n_number | Используется для форматирования вывода числовых значений с учетом текущей локали |
i18n_trim | Версия trim фильтра, поддерживающего корректно UTF-8 строки. Позволяет убирать с конца и с начала строки пробелы или другие символы. |
i18n_clip | Версия clip фильтра, поддерживающего корректно UTF-8 строки. Позволяет ограничить длину выводимой строки. |
Обсуждение