Фільтри для Latte
*****************

.[perex]
Фільтри - це функції, які змінюють або форматують дані до потрібної нам форми. Це короткий огляд вбудованих фільтрів, які доступні.

.[table-latte-filters]
|## Перетворення рядків / масивів
| `batch` | [Перерахування лінійних даних у таблиці |#batch]
| `breakLines` | [вставляє розриви рядків HTML перед усіма новими рядками |#breakLines]
| `bytes` | [форматує розмір у байтах |#bytes]
| `clamp` | [обмежує значення діапазоном |#clamp]
| `dataStream` | [перетворення протоколу URI даних |#dataStream]
| `date` | [форматує дату та час |#date]
| `explode` | [розділяє рядок за заданим роздільником |#explode]
| `first` | [повертає перший елемент масиву або символ рядка |#first]
| `group` | [групує дані за різними критеріями |#group]
| `implode` | [з'єднує масив із ряд ком|#implode]
| `indent` | [відступи тексту зліва з кількістю табуляцій |#indent]
| `join` | [приєднує масив до ряд ка|#implode]
| `last` | [повертає останній елемент масиву або символ рядка|#last]
| `length` | [повертає довжину рядка або масиву |#length]
| `localDate` | [форматує дату і час відповідно до місцевості |#localDate]
| `number` | [форматує число |#number]
| `padLeft` | [завершує рядок до заданої довжини зліва |#padLeft]
| `padRight` | [завершує рядок до заданої довжини справа |#padRight]
| `random` | [повертає випадковий елемент масиву або символ рядка|#random]
| `repeat` | [повторює рядок|#repeat]
| `replace` | [замінює всі входження шуканого рядка заміною |#replace]
| `replaceRE` | [замінює всі входження відповідно до регулярного виразу |#replaceRE]
| `reverse` | [інвертує рядок або масив у форматі UTF-8 |#reverse]
| `slice` | [витягує фрагмент масиву або рядка |#slice]
| `sort` | [сортує масив |#sort]
| `spaceless` | [видаляє пробільні символи |#spaceless], аналогічно тегу [spaceless |tags]
| `split` | [розділяє рядок за заданим роздільником |#explode]
| `strip` | [видаляє пробіли |#spaceless]
| `stripHtml` | [видаляє HTML-теги і перетворює HTML-сутності в текст |#stripHtml]
| `substr` | [повертає частину рядка |#substr]
| `trim` | [видаляє пробіли з рядка |#trim]
| `translate` | [переклад іншими мовами |#translate]
| `truncate` | [скорочує довжину, зберігаючи цілі слова |#truncate]
| `webalize` | [приводить рядок UTF-8 у відповідність до форми, що використовується в URL-адресі |#webalize]

.[table-latte-filters]
|## Буквений регістр
| `capitalize` | [нижній регістр, перша буква кожного слова у верхньому регістрі |#capitalize]
| `firstUpper` | [робить першу букву у верхньому регістрі |#firstUpper]
| `lower` | [робить рядок рядковим |#lower]
| `upper` | [робить рядок у верхньому регістрі |#upper]

.[table-latte-filters]
|## Округлення чисел
| `ceil` | [округлює число в більший бік із заданою точністю |#ceil]
| `floor` | [округлює число в менший бік із заданою точністю |#floor]
| `round` | [округлення числа до заданої точності |#round]

.[table-latte-filters]
|## Ескапування
| `escapeUrl` | [екранує параметр в URL |#escapeUrl]
| `noescape` | [друкує змінну без екранування |#noescape]
| `query` | [формує рядок запиту в URL |#query]

Існують також фільтри екранування для HTML (`escapeHtml` і `escapeHtmlComment`), XML (`escapeXml`), JavaScript (`escapeJs`), CSS (`escapeCss`) і iCalendar (`escapeICal`), які Latte використовує сам завдяки [контекстно-залежному екрануванню |safety-first#Context-Aware-Escaping], і вам не потрібно їх писати.

.[table-latte-filters]
|## Безпека
| `checkUrl` | [Санує рядок для використання всередині атрибута href |#checkUrl]
| `nocheck` | [запобігає автоматичній санації URL |#nocheck]

Latte [перевіряє |safety-first#Link-Checking] атрибути `src` і `href` [автоматично |safety-first#Link-Checking], тому вам майже не потрібно використовувати фільтр `checkUrl`.


.[note]
Всі вбудовані фільтри працюють з рядками в кодуванні UTF-8.


Використання .[#toc-usage]
==========================

Latte дозволяє викликати фільтри, використовуючи нотацію знака труби (пробіл перед ним допускається):

```latte
<h1>{$heading|upper}</h1>
```

Фільтри можуть бути з'єднані ланцюжком, тоді вони застосовуються в порядку зліва направо:

```latte
<h1>{$heading|lower|capitalize}</h1>
```

Параметри вказуються після назви фільтра через двокрапку або кому:

```latte
<h1>{$heading|truncate:20,''}</h1>
```

Фільтри можна застосовувати до виразу:

```latte
{var $name = ($title|upper) . ($subtitle|lower)}</h1>
```

Таким чином можна зареєструвати[власні фільтри |extending-latte#filters]:

```php
$latte = new Latte\Engine;
$latte->addFilter('shortify', fn(string $s, int $len = 10) => mb_substr($s, 0, $len));
```

Ми використовуємо його в такому шаблоні:

```latte
<p>{$text|shortify}</p>
<p>{$text|shortify:100}</p>
```


Фільтри .[#toc-filters]
=======================


batch(int $length, mixed $item): array .[filter]
------------------------------------------------
Фільтр, який спрощує виведення лінійних даних у вигляді таблиці. Повертає масив із заданою кількістю елементів. Якщо ви вкажете другий параметр, він буде використаний для заповнення пропущених елементів в останньому рядку.

```latte
{var $items = ['a', 'b', 'c', 'd', 'e']}
<table>
{foreach ($items|batch: 3, 'No item') as $row}
	<tr>
		{foreach $row as $column}
			<td>{$column}</td>
		{/foreach}
	</tr>
{/foreach}
</table>
```

Виводить на друк:

```latte
<table>
	<tr>
		<td>a</td>
		<td>b</td>
		<td>c</td>
	</tr>
	<tr>
		<td>d</td>
		<td>e</td>
		<td>No item</td>
	</tr>
</table>
```

Дивіться також тег [group |#group] та [iterateWhile |tags#iterateWhile].


breakLines .[filter]
--------------------
Вставляє розриви рядків HTML перед усіма новими рядками.

```latte
{var $s = "Text & with \n newline"}
{$s|breakLines}    {* результати "Text &amp; with <br>\n newline" *}
```


bytes(int $precision=2) .[filter]
---------------------------------
Форматує розмір у байтах у зручну для читання форму. Якщо задано [локаль |develop#locale], використовуються відповідні десяткові та тисячні роздільники.

```latte
{$size|bytes}     0 B, 1.25 GB, …
{$size|bytes:0}   10 B, 1 GB, …
```


ceil(int $precision=0) .[filter]
--------------------------------
Округлює число до заданої точності.

```latte
{=3.4|ceil}         {* виводиться 4 *}
{=135.22|ceil:1}    {* виводиться 135.3 *}
{=135.22|ceil:3}    {* виводиться 135.22 *}
```

Див. також [floor |#floor], [round |#round].


capitalize .[filter]
--------------------
Повертає версію значення у вигляді заголовка. Слова починаються з великих літер, всі інші символи - з малих. Потрібне розширення PHP `mbstring`.

```latte
{='i like LATTE'|capitalize} {* виводить 'I Like Latte' *}
```

Див. також [firstUpper |#firstUpper], [lower |#lower], [upper |#upper].


checkUrl .[filter]
------------------
Застосовує санітарну обробку URL-адрес. Перевіряє, чи містить змінна веб-адресу (тобто протокол HTTP/HTTPS) і запобігає запису посилань, які можуть становити загрозу безпеці.

```latte
{var $link = 'javascript:window.close()'}
<a data-href={$link|checkUrl}>checked</a>
<a data-href={$link}>unchecked</a>
```

Виводить на друк:

```latte
<a data-href="">checked</a>
<a data-href="javascript:window.close()">unchecked</a>
```

Див. також [nocheck |#nocheck].


clamp(int|float $min, int|float $max) .[filter]
-----------------------------------------------
Повертає значення, обмежене діапазоном min та max.

```latte
{$level|clamp: 0, 255}
```

Існує також у вигляді [функції |functions#clamp].


dataStream(string $mimetype=detect) .[filter]
---------------------------------------------
Перетворює вміст на схему URI даних. Його можна використовувати для вставки зображень в HTML або CSS без необхідності посилання на зовнішні файли.

Нехай у змінній є зображення `$img = Image::fromFile('obrazek.gif')`, тоді

```latte
<img src={$img|dataStream}>
```

Виводить, наприклад:

```latte
<img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA
AAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO
9TXL0Y4OHwAAAABJRU5ErkJggg==">
```

.[caution]
Потрібне розширення PHP `fileinfo`.


date(string $format) .[filter]
------------------------------
Форматує дату і час відповідно до маски, що використовується функцією PHP [php:date]. Фільтр приймає дату у форматі мітки часу UNIX, як рядок або як об'єкт `DateTimeInterface`.

```latte
{$today|date:'j. n. Y'}
```

Дивіться також [localDate |#localDate].


escapeUrl .[filter]
-------------------
Екранує змінну, яка буде використана як параметр в URL.

```latte
<a href="http://example.com/{$name|escapeUrl}">{$name}</a>
```

Див. також [query |#query].


explode(string $separator='') .[filter]
---------------------------------------
Розділяє рядок за заданим роздільником і повертає масив рядків. Псевдонім для `split`.

```latte
{='one,two,three'|explode:','}    {* returns ['one', 'two', 'three'] *}
```

Якщо роздільник є порожнім рядком (значення за замовчуванням), вхідні дані буде розділено на окремі символи:

```latte
{='123'|explode}                  {* returns ['1', '2', '3'] *}
```

Ви також можете використовувати псевдонім `split`:

```latte
{='1,2,3'|split:','}              {* returns ['1', '2', '3'] *}
```

Див. також [implode |#implode].


first .[filter]
---------------
Повертає перший елемент масиву або символ рядка:

```latte
{=[1, 2, 3, 4]|first}    {* outputs 1 *}
{='abcd'|first}          {* outputs 'a' *}
```

Див. також [last |#last], [random |#random].


floor(int $precision=0) .[filter]
---------------------------------
Округлює число до заданої точності.

```latte
{=3.5|floor}        {* outputs 3      *}
{=135.79|floor:1}   {* outputs 135.7  *}
{=135.79|floor:3}   {* outputs 135.79 *}
```

Див. також [ceil |#ceil], [round |#round].


firstUpper .[filter]
--------------------
Перетворює першу літеру значення у верхній регістр. Потрібне розширення PHP `mbstring`.

```latte
{='the latte'|firstUpper}  {* outputs 'The latte' *}
```

Див. також [capitalize |#capitalize], [lower |#lower] регістр, [upper |#upper] регістр.


group(string|int|\Closure $by): array .[filter]{data-version:3.0.16}
--------------------------------------------------------------------
Фільтр групує дані за різними критеріями.

У цьому прикладі рядки таблиці групуються за стовпцем `categoryId`. На виході отримуємо масив масивів, де ключем є значення у стовпчику `categoryId`. Прочитайте [детальну інструкцію |cookbook/grouping].

```latte
{foreach ($items|group: categoryId) as $categoryId => $categoryItems}
    <ul>
        {foreach $categoryItems as $item}
            <li>{$item->name}</li>
        {/foreach}
    </ul>
{/foreach}
```

Дивіться також [batch |#batch], функцію [group |functions#group] та тег [iterateWhile |tags#iterateWhile].


implode(string $glue='') .[filter]
----------------------------------
Повертає рядок, який є конкатенацією рядків у масиві. Псевдонім для `join`.

```latte
{=[1, 2, 3]|implode}      {* outputs '123' *}
{=[1, 2, 3]|implode:'|'}  {* outputs '1|2|3' *}
```

Ви також можете використовувати псевдонім `join`:

```latte
{=[1, 2, 3]|join}         {* outputs '123' *}
```


indent(int $level=1, string $char="\t") .[filter]
-------------------------------------------------
Відступає текст зліва на задану кількість табуляцій або інших символів, які ми вказуємо у другому необов'язковому аргументі. Порожні рядки не відступаються.

```latte
<div>
{block |indent}
<p>Hello</p>
{/block}
</div>
```

Друкує:

```latte
<div>
	<p>Hello</p>
</div>
```


last .[filter]
--------------
Повертає останній елемент масиву або символ рядка:

```latte
{=[1, 2, 3, 4]|last}    {* outputs 4 *}
{='abcd'|last}          {* outputs 'd' *}
```

Див. також [first |#first], [random |#random].


length .[filter]
----------------
Повертає довжину рядка або масиву.

- для рядків повертає довжину в символах UTF-8
- для масивів - кількість елементів
- для об'єктів, що реалізують інтерфейс Countable, буде використовувати значення, що повертається функцією count()
- для об'єктів, що реалізують інтерфейс IteratorAggregate, буде використовувати значення, що повертається функцією iterator_count()


```latte
{if ($users|length) > 10}
	...
{/if}
```


localDate(?string $format=null, ?string $date=null, ?string $time=null) .[filter]
---------------------------------------------------------------------------------
Форматує дату і час відповідно до [локалі |develop#locale], забезпечуючи узгоджене і локалізоване відображення часових даних у різних мовах і регіонах. Фільтр приймає дату у вигляді мітки часу UNIX, рядка або об'єкта `DateTimeInterface`.

```latte
{$date|localDate}                  {* 15. dubna 2024 *}
{$date|format: yM}                 {* 4/2024 *}
{$date|localDate: date: medium}    {* 15. 4. 2024 *}
```

Якщо ви використовуєте фільтр без жодних параметрів, він виведе дату в довгому форматі, як пояснюється далі.

**a) Використання формату**

Параметр `format` описує, які компоненти часу слід відображати. Він використовує літерні коди, де кількість повторень впливає на ширину виводу:

| Рік | `y` / `yy` / `yyyy` | `2024` / `24` / `2024`
| Місяць | `M` / `MM` / `MMM` / `MMMM` | `8` / `08` / `сер` / `серпень`
| День | `d` / `dd` / `E` / `EEEE` | `1` / `01` / `нд` / `неділя`
| Година | `j` / `H` / `h` | бажана / 24-годинна / 12-годинна
| Хвилина | `m` / `mm` | `5` / `05` <small>(2 цифри в поєднанні з секундами)</small>
| Секунда | `s` / `ss` | `8` / `08` <small>(2 цифри у поєднанні з хвилинами)</small>

Порядок кодів у форматі не має значення, оскільки порядок компонентів буде відображено відповідно до умов локалізації. Таким чином, формат не залежить від локалі. Наприклад, формат `yyyyMMMMd` у локалі `en_US` виводить `April 15, 2024`, тоді як у локалі `cs_CZ` він виводить `15. dubna 2024`:

| locale:  | uk-UA | en_US
|---
| `format: 'dMy'` | 10.08.2024 | 8/10/2024
| `format: 'yM'` | 08.2024 | 8/2024
| `format: 'yyyyMMMM'` | серпень 2024 р. | August 2024
| `format: 'MMMM'` | серпень | August
| `format: 'jm'` | 17:54 | 5:54 PM
| `format: 'Hm'` | 17:54 | 17:54
| `format: 'hm'` | 5:54 пп | 5:54 PM


**b) Використання попередньо встановлених стилів**

Параметри `date` і `time` визначають рівень деталізації відображення дати і часу. Ви можете вибрати один з декількох рівнів: `full`, `long`, `medium`, `short`. Ви можете відображати лише дату, лише час або обидва:

| locale:  | uk-UA | en_US
|---
| `date: short` | 23.01.78 | 1/23/78
| `date: medium` | 23 січ. 1978 р. | Jan 23, 1978
| `date: long` | 23 січня 1978 р. | January 23, 1978
| `date: full` | понеділок, 23 січня 1978 р. | Monday, January 23, 1978
| `time: short` | 08:30 | 8:30 AM
| `time: medium` | 08:30:59 | 8:30:59 AM
| `time: long` | 08:30:59 GMT+1 | 8:30:59 AM GMT+1
| `date: short, time: short` | 23.01.78, 08:30 | 1/23/78, 8:30 AM
| `date: medium, time: short` | 23 січ. 1978 р., 08:30 | Jan 23, 1978, 8:30 AM
| `date: long, time: short` | 23 січня 1978 р. о 08:30 | January 23, 1978 at 8:30 AM

Для дати можна також використовувати префікс `relative-` (наприклад, `relative-short`), який для дат, близьких до теперішнього часу, покаже `yesterday`, `today` або `tomorrow`; в іншому випадку, він буде відображатися стандартним чином.

```latte
{$date|localDate: date: relative-short}    {* yesterday *}
```

Див. також [дата |#date].


lower .[filter]
---------------
Перетворює значення в нижній регістр. Потрібне розширення PHP `mbstring`.

```latte
{='LATTE'|lower}   {* outputs 'latte' *}
```

Див. також [capitalize |#capitalize], [firstUpper |#firstUpper], [upper |#upper].


nocheck .[filter]
-----------------
Запобігає автоматичній санітарній обробці URL-адрес. Latte [автоматично перевіряє |safety-first#Link checking], чи містить змінна веб-адресу (тобто протокол HTTP/HTTPS) і запобігає запису посилань, які можуть становити загрозу безпеці.

Якщо посилання використовує іншу схему, наприклад, `javascript:` або `data:`, і ви впевнені в його вмісті, ви можете відключити перевірку через `|nocheck`.

```latte
{var $link = 'javascript:window.close()'}

<a href={$link}>checked</a>
<a href={$link|nocheck}>unchecked</a>
```

Відбитки:

```latte
<a href="">checked</a>
<a href="javascript:window.close()">unchecked</a>
```

Див. також [checkUrl |#checkUrl].


noescape .[filter]
------------------
Вимикає автоматичне екранування.

```latte
{var $trustedHtmlString = '<b>hello</b>'}
Escaped: {$trustedHtmlString}
Unescaped: {$trustedHtmlString|noescape}
```

Друкує:

```latte
Escaped: &lt;b&gt;hello&lt;/b&gt;
Unescaped: <b>hello</b>
```

.[warning]
Неправильне використання фільтра `noescape` може призвести до XSS-уразливості! Ніколи не використовуйте його, якщо ви не впевнені в тому, що ви робите, і що рядок, який ви друкуєте, походить з надійного джерела.


number(int $decimals=0, string $decPoint='.', string $thousandsSep=',') .[filter]
---------------------------------------------------------------------------------
Форматує число до вказаної кількості десяткових знаків. Якщо задано [локаль |develop#locale], використовуються відповідні роздільники десяткових і тисячних знаків.

```latte
{1234.20|number} 1,234
{1234.20 |number:1}            1,234.2
{1234.20 |number:2}            1,234.20
{1234.20|number:2, ',', ' '}  1 234,20
```


number(string $format) .[filter]
--------------------------------
Параметр `format` дозволяє визначити зовнішній вигляд чисел точно відповідно до ваших потреб. Для цього потрібна встановлена [локаль |develop#locale]. Формат складається з декількох спеціальних символів, повний опис яких можна знайти в документації "DecimalFormat":https://unicode.org/reports/tr35/tr35-numbers.html#Number_Format_Patterns:

- <c id=6/> обов'язкова цифра, завжди відображається, навіть якщо це нуль
- `#` необов'язкова цифра, відображається тільки якщо на цьому місці в числі є цифра
- `@` значуща цифра, допомагає відобразити число з певною кількістю значущих цифр
- `.` позначає, де повинен стояти десятковий роздільник (кома або крапка, залежно від локалі)
- `,` використовується для відокремлення груп цифр, зазвичай тисяч
- `%` множить число на 100 і додає знак відсотків

Розглянемо кілька прикладів. У першому прикладі два знаки після коми є обов'язковими, у другому - необов'язковими. У третьому прикладі з обох боків додаються нулі, а в четвертому відображаються лише наявні цифри:

```latte
{1234.5|number: '#,##0.00'}     {* 1,234.50 *}
{1234.5|number: '#,##0.##'}     {* 1,234.5 *}
{1.23  |number: '000.000'}      {* 001.230 *}
{1.2   |number: '##.##'}        {* 1.2 *}
```

Значущі цифри визначають, скільки цифр, незалежно від десяткової крапки, слід відображати, округлюючи число, якщо це необхідно:

```latte
{1234|number: '@@'}             {* 1200 *}
{1234|number: '@@@'}            {* 1230 *}
{1234|number: '@@@#'}           {* 1234 *}
{1.2345|number: '@@@'}          {* 1.23 *}
{0.00123|number: '@@'}          {* 0.0012 *}
```

Простий спосіб відобразити число у відсотках. Число множиться на 100 і додається знак `%`:

```latte
{0.1234|number: '#.##%'}        {* 12.34% *}
```

Ми можемо визначити різний формат для додатних і від'ємних чисел, розділених символом `;`. Таким чином, наприклад, додатні числа можуть відображатися зі знаком `+`:

```latte
{42|number: '#.##;(#.##)'}      {* 42 *}
{-42|number: '#.##;(#.##)'}     {* (42) *}
{42|number: '+#.##;-#.##'}      {* +42 *}
{-42|number: '+#.##;-#.##'}     {* -42 *}
```

Пам'ятайте, що фактичний вигляд чисел може відрізнятися залежно від налаштувань локалі. Наприклад, у деяких країнах замість крапки в якості десяткового роздільника використовується кома. Цей фільтр автоматично враховує це, тому вам не потрібно про це турбуватися.


padLeft(int $length, string $pad=' ') .[filter]
-----------------------------------------------
Доповнює рядок до певної довжини іншим рядком зліва.

```latte
{='hello'|padLeft: 10, '123'}  {* outputs '12312hello' *}
```


padRight(int $length, string $pad=' ') .[filter]
------------------------------------------------
Заміщає рядок до певної довжини іншим рядком праворуч.

```latte
{='hello'|padRight: 10, '123'}  {* outputs 'hello12312' *}
```


query  .[filter]
----------------
Динамічно генерує рядок запиту в URL:

```latte
<a href="http://example.com/?{[name: 'John Doe', age: 43]|query}">click</a>
<a href="http://example.com/?search={$search|query}">search</a>
```

Друкує:

```latte
<a href="http://example.com/?name=John+Doe&amp;age=43">click</a>
<a href="http://example.com/?search=Foo+Bar">search</a>
```

Ключі зі значенням `null` пропущено.

Дивіться також [escapeUrl |#escapeUrl].


random .[filter]
----------------
Повертає випадковий елемент масиву або символ рядка:

```latte
{=[1, 2, 3, 4]|random}    {* example output: 3 *}
{='abcd'|random}          {* example output: 'b' *}
```

Дивіться також [first |#first], [last |#last].


repeat(int $count) .[filter]
----------------------------
Повторює рядок x разів.

```latte
{='hello'|repeat: 3}  {* outputs 'hellohellohello' *}
```


replace(string|array $search, string $replace='') .[filter]
-----------------------------------------------------------
Замінює всі входження пошукового рядка на рядок заміни.

```latte
{='hello world'|replace: 'world', 'friend'}  {* outputs 'hello friend' *}
```

Можна зробити кілька замін одночасно:

```latte
{='hello world'|replace: [h => l, l => h]}  {* outputs 'lehho worhd' *}
```


replaceRE(string $pattern, string $replace='') .[filter]
--------------------------------------------------------
Замінює всі входження відповідно до регулярного виразу.

```latte
{='hello world'|replaceRE: '/l.*/', 'l'}  {* outputs 'hel' *}
```


reverse .[filter]
-----------------
Реверсує заданий рядок або масив.

```latte
{var $s = 'Nette'}
{$s|reverse}    {* outputs 'etteN' *}
{var $a = ['N', 'e', 't', 't', 'e']}
{$a|reverse}    {* returns ['e', 't', 't', 'e', 'N'] *}
```


round(int $precision=0) .[filter]
---------------------------------
Округляє число до заданої точності.

```latte
{=3.4|round}        {* outputs 3      *}
{=3.5|round}        {* outputs 4      *}
{=135.79|round:1}   {* outputs 135.8  *}
{=135.79|round:3}   {* outputs 135.79 *}
```

Див. також [ceil |#ceil], [floor |#floor].


slice(int $start, ?int $length=null, bool $preserveKeys=false) .[filter]
------------------------------------------------------------------------
Витягує фрагмент масиву або рядка.

```latte
{='hello'|slice: 1, 2}           {* outputs 'el' *}
{=['a', 'b', 'c']|slice: 1, 2}   {* outputs ['b', 'c'] *}
```

Фільтр фрагментів працює як PHP-функція `array_slice` для масивів і `mb_substr` для рядків з переходом на `iconv_substr` в режимі UTF-8.

Якщо початок невід'ємний, послідовність почнеться з цього початку у змінній. Якщо start від'ємне, послідовність почнеться на відстані від кінця змінної.

Якщо задано довжину і вона додатна, то послідовність міститиме стільки елементів, скільки вказано у змінній. Якщо довжина змінної менша за довжину, то в послідовності будуть присутні лише доступні елементи змінної. Якщо задано від'ємне значення довжини, то послідовність зупиниться за стільки-то елементів від кінця змінної. Якщо довжину не вказано, то послідовність міститиме всі елементи від зсуву до кінця змінної.

За замовчуванням фільтр перевпорядковує і скидає ключі цілочисельних масивів. Цю поведінку можна змінити, встановивши preserveKeys у true. Рядкові ключі завжди зберігаються, незалежно від цього параметра.


sort(?Closure $comparison, string|int|\Closure|null $by=null, string|int|\Closure|bool $byKey=false) .[filter]
--------------------------------------------------------------------------------------------------------------
Фільтр сортує елементи масиву або ітератора зі збереженням їхніх асоціативних ключів. Якщо задано [локаль |develop#locale], сортування відбувається за її правилами, якщо не вказано власну функцію порівняння.

```latte
{foreach ($names|sort) as $name}
	...
{/foreach}
```

Масив відсортовано у зворотному порядку.

```latte
{foreach ($names|sort|reverse) as $name}
	...
{/foreach}
```

Ви можете вказати власну функцію порівняння для сортування (у прикладі показано, як змінити сортування від найбільшого до найменшого):

```latte
{var $reverted = ($names|sort: fn($a, $b) => $b <=> $a)}
```

Фільтр `|sort` також дозволяє сортувати елементи за ключем:

```latte
{foreach ($names|sort: byKey: true) as $name}
	...
{/foreach}
```

Якщо вам потрібно відсортувати таблицю за певним стовпцем, ви можете використовувати параметр `by`. Значення `'name'` у прикладі вказує, що сортування буде виконано за `$row->name` або `$row['name']`залежно від того, чи є `$row` масивом або об'єктом:

```latte
{foreach ($items|sort: by: 'name') as $item}
	{$item->name}
{/foreach}
```

Ви також можете визначити функцію зворотного виклику, яка визначає значення для сортування:

```latte
{foreach ($items|sort: by: fn($items) => $items->category->name) as $item}
	{$item->name}
{/foreach}
```

Параметр `byKey` можна використовувати так само.


spaceless  .[filter]
--------------------
Видаляє непотрібні пробіли з виводу. Також можна використовувати псевдонім `strip`.

```latte
{block |spaceless}
	<ul>
		<li>Hello</li>
	</ul>
{/block}
```

Друкує:

```latte
<ul> <li>Hello</li> </ul>
```


stripHtml .[filter]
-------------------
Перетворює HTML на звичайний текст. Тобто видаляє HTML-теги і перетворює HTML-об'єкти на текст.

```latte
{='<p>one &lt; two</p>'|stripHtml}  {* outputs 'one < two' *}
```

Отриманий в результаті звичайний текст може містити символи, які представляють теги HTML, наприклад, `'&lt;p&gt;'|stripHtml` буде перетворено на `<p>`. Ніколи не виводьте отриманий текст у вигляді `|noescape`, оскільки це може призвести до уразливості.


substr(int $offset, ?int $length=null) .[filter]
------------------------------------------------
Витягує фрагмент рядка. Цей фільтр було замінено на фільтр [фрагментів |#slice].

```latte
{$string|substr: 1, 2}
```


translate(...$args) .[filter]
-----------------------------
Перекладає вирази на інші мови. Щоб зробити фільтр доступним, вам потрібно [налаштувати пере |develop#TranslatorExtension]кладач. Ви також можете використовувати [теги для перекладу |tags#Translation].

```latte
<a href="basket">{='Baskter'|translate}</a>
<span>{$item|translate}</span>
```


trim(string $charlist=" \t\n\r\0\x0B\u{A0}") .[filter]
------------------------------------------------------
Видаляти початкові та кінцеві символи, за замовчуванням пробіли.

```latte
{='  I like Latte.  '|trim}    {* outputs 'I like Latte.' *}
{='  I like Latte.'|trim: '.'} {* outputs '  I like Latte' *}
```


truncate(int $length, string $append='…') .[filter]
---------------------------------------------------
Скорочує рядок до максимально заданої довжини, але намагається зберегти цілі слова. Якщо рядок укорочено, додає в кінці багатокрапку (це можна змінити за допомогою другого параметра).

```latte
{var $title = 'Hello, how are you?'}
{$title|truncate:5}  {* Hell…                *}
{$title|truncate:17} {* Hello, how are…      *}
{$title|truncate:30} {* Hello, how are you?  *}
```


upper .[filter]
---------------
Перетворює значення у верхній регістр. Потрібне розширення PHP `mbstring`.

```latte
{='latte'|upper}  {* outputs 'LATTE' *}
```

Дивіться також [capitalize |#capitalize], [firstUpper |#firstUpper], [lower |#lower].


webalize .[filter]
------------------
Перетворює в ASCII.

Перетворює пробіли на дефіси. Видаляє символи, які не є алфавітно-цифровими, підкресленнями або дефісами. Перетворює на малі літери. Також видаляє пробіли на початку та в кінці тексту.

```latte
{var $s = 'Our 10. product'}
{$s|webalize}    {* outputs 'our-10-product' *}
```

.[caution]
Потрібен пакунок [nette/utils |utils:].