====== Фильтры шаблонной системы WACT (включая специфичные для Limb фильтры) ======
===== WACT Core _filters (Базовые фильтры WACT) =====

Описание фильтров содержат примеры. Рабочие примеры применения фильтров можно найти в папке **limb/wact/examples/filters/core/**.

^Фильтр^Описание^
|Расположение: **limb/wact/src/tags/core/**||
|[[.filters:core_filters:capitalize_filter|capitalize]]|Враппер для php-функции ucfirst. Приводит первую букву значения переменной в верхний регистр.|
|[[.filters:core_filters:lower_case_filter|lowercase]] | Враппер для php-функции strtolower(). Приводит значение переменной в нижний регистр.|
|[[.filters:core_filters:upper_case_filter|uppercase]] | Враппер для php-функции strtoupper(). Приводит значение переменной в верхний регистр.|
|[[.filters:core_filters:default_filter|default]] | Позволяет указать значение по-умолчанию в выражении для вывода переменной, если значение переменной пусто.|
|[[.filters:core_filters:html_filter|html]] | Враппер для php-функции htmlspecialchars(). Обрабатывает значение переменной при помощи этой функции, приводя код к безопасному для просмотра виду. Применяется по-умолчания для всех выражений.|
|[[.filters:core_filters:raw_filter|raw]] | Выводит значение переменной в неименной виде. Дело в том, что по-умолчанию, значение переменной обрабатывается htmlspecialchars. Если указан данный фильтр, то такая обработка не производится.|
|[[.filters:core_filters:no_tags_filter|notags]] | Враппер для php-функции strip_tags(). Убирает из значения переменной все теги.|
|[[.filters:core_filters:nl2br_filter|nl2br]] | Враппер для php-функции nl2br(). Позволяет выводить текст в браузере. Добавляет рядом с символом \n тег <br/>.| 
|[[.filters:core_filters:safe_js_text_filter|safe_js_text]] | Заменяет все символы новой строки на <br/>, в отличие от фильтра nl2br, который добавляет к \n тег <br/>. Фильтр safe_js_text обычно используется при формировании JS-кода.|
|[[.filters:core_filters:date_filter|date]] | Враппер для php-функции date(). Позволяет форматировать вывод дат.|
|[[.filters:core_filters:number_filter|number]] | Враппер для функции number_format(). Позволяет форматировать вывод чисел.|
|[[.filters:core_filters:trim_filter|trim]] | Враппер для php-функции trim(). Позволяет убирать с конца и с начала строки пробелы или другие символы.|
|[[.filters:core_filters:word_wrap_filter|wordwrap]] | Враппер для php-функции wordwrap(). Позволяет разбивать предложения на составляющие. Части предложения разделяются знаком "\n".|
|[[.filters:core_filters:url_filter|url]] | Враппер для php-функции urlencode(). |
|[[.filters:core_filters:utf8_encode_filter|utf8encode]] | Враппер для php-функции utf8_encode(). |

===== WACT Data Filters =====

^Фильтр^Описание^
|Расположение: **limb/wact/src/tags/data/**||
|[[.filters:data_filters:clip_filter|clip]]|Враппер для php-функции substr(). Позволяет ограничить вывод длинной строки, указывая количество символов, отступ, и символы на границах.|
|[[.filters:data_filters:math_filter|math]]|Позволяет производить несложные математически операции прямо в шаблоне.|
|[[.filters:data_filters:stats_filter|stats]]|Позволяет производить несложные статистические операции прямо в шаблоне.|
===== Limb I18N _filters (Фильтры для работы с UTF-8 строками) =====

Фильтры требуют пакета [[limb3:ru:packages:web_app|WEB_APP]] и пакета [[limb3:ru:packages:i18n|I18N]] (он устанавливается автоматически вместе в пакетом WEB_APP).

^Фильтр^Описание^
|Расположение: **limb/wab_app/src/template/tags/i18n/**||
|[[.filters:lmbi18n_filters:lmbi18n_string_filter|i18n]]|враппер для глобальной Limb функции tr. Используется для перевода текстовых строк.|
|[[.filters:lmbi18n_filters:lmbi18n_capitalize_filter|i18n_capitalize]]|Версия capitalize фильтра, поддерживающего корректно UTF-8 строки. Враппер для функции _ucfirst(), объявленная в пакете I18N. Приводит первую букву значения переменной в верхний регистр.|
|[[.filters:lmbi18n_filters:lmbi18n_uppercase_filter|i18n_uppercase]] | Версия uppercase фильтра, поддерживающего корректно UTF-8 строки. Враппер для функции _strtoupper(), объявленной в пакете I18N. Приводит значение переменной в верхний регистр.|
|[[.filters:lmbi18n_filters:lmbi18n_lowercase_filter|i18n_lowercase]] | Версия lowercase фильтра, поддерживающего корректно UTF-8 строки. Враппер для функции _strtolower(), объявленной в пакете I18N. Приводит значение переменной в нижний регистр.|
|[[.filters:lmbi18n_filters:lmbi18n_date_filter|i18n_date]] | Используется для форматирования вывода локализованных дат.|
|[[.filters:lmbi18n_filters:lmbi18n_number_filter|i18n_number]] | Используется для форматирования вывода числовых значений с учетом текущей локали|
|[[.filters:lmbi18n_filters:lmbi18n_trim_filter|i18n_trim]] | Версия trim фильтра, поддерживающего корректно UTF-8 строки. Позволяет убирать с конца и с начала строки пробелы или другие символы.|
|[[.filters:lmbi18n_filters:lmbi18n_clip_filter|i18n_clip]] | Версия clip фильтра, поддерживающего корректно UTF-8 строки. Позволяет ограничить длину выводимой строки.|