====== Фильтры ======


Фильтры - предназначены для модифицирования значения переменной или строки при выводе в шаблон при помощи [[.expressions|выражений]].

Фильтры отделяются от остальной части выражения вертикальным разделителем. Несколько фильтров в выражении разделяются также вертикальным разделителем:

<code>
{$UserName|trim|capitalize}
</code>

В данном примере, фильтр trim сначала убирает пробелы с конца и сначала строки (значения переменной UserName), а затем capitalize переводит первую букву строки в верхний регистр.

К фильтрам могут применяться дополнительные параметры. Параметры начинаются после знака двоеточия, сами параметры отделяются друг от друга запятыми:

<code>
{$UserName|default:"anonymous"}
{$value|number:2, '. ', ' '}
</code>

В первом случае, фильтр выведет значение “anonymous”, если переменная UserName не будет определена в контейнере данных при исполнении шаблона.

В качестве параметров также допускается использование выражений для получения данных:

<code>
<core:set size="10"/>
<pre>{$PlainText|wordwrap:size}</pre>
</code>

Чаще всего в виде фильтров реализуются php-функции, такие как trim, strtoupper и т.д. WACT содержит достаточно большой список фильтров.

В выражениях по-умолчанию применяется html, то есть применяется функция htmlspecialchars. Для того, чтобы отметить его действие, используйте фильтр raw:

<code>
{$CommentHtml|raw}
</code>

[[limb3:ru:packages:wact:filters|Словарь фильтров]]