Skip to content

Commit

Permalink
[filter] has same signature as [method]
Browse files Browse the repository at this point in the history
  • Loading branch information
dg committed Oct 23, 2024
1 parent 88e5c68 commit ba24c4e
Show file tree
Hide file tree
Showing 17 changed files with 768 additions and 768 deletions.
92 changes: 46 additions & 46 deletions latte/bg/filters.texy
Original file line number Diff line number Diff line change
Expand Up @@ -120,8 +120,8 @@ $latte->addFilter('shortify', fn(string $s, int $len = 10) => mb_substr($s, 0, $
======================


batch(int length, mixed item): array .[filter]
----------------------------------------------
batch(int $length, mixed $item): array .[filter]
------------------------------------------------
Филтър, който опростява изписването на линейни данни под формата на таблица. Връща масив от масиви със зададения брой елементи. Ако предоставите втори параметър, той се използва за попълване на липсващите елементи на последния ред.

```latte
Expand Down Expand Up @@ -167,8 +167,8 @@ breakLines .[filter]
```


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

```latte
Expand All @@ -177,8 +177,8 @@ bytes(int precision = 2) .[filter]
```


ceil(int precision = 0) .[filter]
---------------------------------
ceil(int $precision=0) .[filter]
--------------------------------
Закръгляне на число до зададена точност.

```latte
Expand Down Expand Up @@ -221,8 +221,8 @@ checkUrl .[filter]
Вижте също [nocheck |#nocheck].


clamp(int|float min, int|float max) .[filter]
---------------------------------------------
clamp(int|float $min, int|float $max) .[filter]
-----------------------------------------------
Връща стойността, която е вкарана в обхват от min и max.

```latte
Expand All @@ -232,8 +232,8 @@ clamp(int|float min, int|float max) .[filter]
Съществува и като [clamp |functions#clamp].


dataStream(string mimetype = detect) .[filter]
----------------------------------------------
dataStream(string $mimetype=detect) .[filter]
---------------------------------------------
Конвертира съдържанието в схема URI за данни. Може да се използва за вмъкване на изображения в HTML или CSS, без да е необходимо да се свързват външни файлове.

Нека имаме изображение в променлива `$img = Image::fromFile('obrazek.gif')`, тогава
Expand All @@ -254,8 +254,8 @@ AAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO
Изисква PHP разширение `fileinfo`.


date(string format) .[filter]
-----------------------------
date(string $format) .[filter]
------------------------------
Форматира датата и часа в съответствие с маската, използвана от функцията на PHP [php:date]. Филтърът приема датата във формат UNIX timestamp, като низ или като обект `DateTimeInterface`.

```latte
Expand All @@ -276,8 +276,8 @@ escapeUrl .[filter]
Вижте също [query |#query].


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

```latte
Expand Down Expand Up @@ -311,8 +311,8 @@ first .[filter]
Вижте също [last |#last], [random |#random].


floor(int precision = 0) .[filter]
----------------------------------
floor(int $precision=0) .[filter]
---------------------------------
Закръгляне на число до зададена точност.

```latte
Expand All @@ -335,8 +335,8 @@ firstUpper .[filter]
Вижте също [capitalize |#capitalize], [lower |#lower], [upper |#upper].


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

В този пример редовете в таблицата са групирани по колоната `categoryId`. Изходът е масив от масиви, където ключът е стойността в колоната `categoryId`. Прочетете [подробните инструкции |cookbook/grouping].
Expand All @@ -354,8 +354,8 @@ group(string|int|\Closure by): array .[filter]{data-version:3.0.16}
Вижте също [batch |#batch], функцията [group |functions#group] и маркера [iterateWhile |tags#iterateWhile].


implode(string glue = '') .[filter]
-----------------------------------
implode(string $glue='') .[filter]
----------------------------------
Връща низ, който е конкатенация на низовете в масива. Псевдоним за `join`.

```latte
Expand All @@ -370,8 +370,8 @@ implode(string glue = '') .[filter]
```


indent(int level = 1, string char = "\t") .[filter]
---------------------------------------------------
indent(int $level=1, string $char="\t") .[filter]
-------------------------------------------------
Отстъпва текста отляво с даден брой табулации или други символи, които посочваме във втория незадължителен аргумент. Празните редове не се отдръпват.

```latte
Expand Down Expand Up @@ -420,7 +420,7 @@ length .[filter]
```


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

Expand Down Expand Up @@ -537,8 +537,8 @@ Unescaped: <b>hello</b>
Злоупотребата с филтъра `noescape` може да доведе до уязвимост XSS! Никога не го използвайте, освен ако не сте **напълно сигурни** какво правите и че низът, който отпечатвате, идва от надежден източник.


number(int decimals = 0, string decPoint = '.', string thousandsSep = ',') .[filter]
------------------------------------------------------------------------------------
number(int $decimals=0, string $decPoint='.', string $thousandsSep=',') .[filter]
---------------------------------------------------------------------------------
Форматира число до определен брой знаци след десетичната запетая. Ако е зададена [локална среда |develop#locale], се използват съответните разделители за десетични знаци и хиляди.

```latte
Expand All @@ -549,9 +549,9 @@ number(int decimals = 0, string decPoint = '.', string thousandsSep = ',') .[fil
```


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

- <c id=6/> задължителна цифра, която винаги се показва, дори ако е нула
- `#` незадължителна цифра, показва се само ако числото има цифра на това място
Expand Down Expand Up @@ -597,7 +597,7 @@ number(string format) .[filter]
Не забравяйте, че действителният вид на числата може да се различава в зависимост от настройките на локала. Например в някои страни като десетичен разделител се използва запетая вместо точка. Този филтър автоматично отчита това, така че не е необходимо да се притеснявате за него.


padLeft(int length, string pad = ' ') .[filter]
padLeft(int $length, string $pad=' ') .[filter]
-----------------------------------------------
Попълва низ с определена дължина с друг низ отляво.

Expand All @@ -606,7 +606,7 @@ padLeft(int length, string pad = ' ') .[filter]
```


padRight(int length, string pad = ' ') .[filter]
padRight(int $length, string $pad=' ') .[filter]
------------------------------------------------
Подвежда низ до определена дължина с друг низ отдясно.

Expand Down Expand Up @@ -648,16 +648,16 @@ random .[filter]
Вижте също [first |#first], [last |#last].


repeat(int count) .[filter]
---------------------------
repeat(int $count) .[filter]
----------------------------
Повтаря символния низ х пъти.

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


replace(string|array search, string replace = '') .[filter]
replace(string|array $search, string $replace='') .[filter]
-----------------------------------------------------------
Заменя всички срещания на търсения низ със заместващия низ.

Expand All @@ -672,7 +672,7 @@ replace(string|array search, string replace = '') .[filter]
```


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

Expand All @@ -693,8 +693,8 @@ reverse .[filter]
```


round(int precision = 0) .[filter]
----------------------------------
round(int $precision=0) .[filter]
---------------------------------
Закръгляне на число до зададена точност.

```latte
Expand All @@ -707,7 +707,7 @@ round(int precision = 0) .[filter]
Вижте също [таван, |#ceil] [етаж |#floor].


slice(int start, int length = null, bool preserveKeys = false) .[filter]
slice(int $start, ?int $length=null, bool $preserveKeys=false) .[filter]
------------------------------------------------------------------------
Извлича част от масив или низ.

Expand All @@ -725,8 +725,8 @@ slice(int start, int length = null, bool preserveKeys = false) .[filter]
По подразбиране Filter ще пренареди и нулира ключовете на целочислените масиви. Това поведение може да бъде променено чрез задаване на стойност preserveKeys на true. Ключовете на низове винаги се запазват, независимо от този параметър.


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

```latte
Expand Down Expand Up @@ -806,17 +806,17 @@ stripHtml .[filter]
Полученият обикновен текст естествено може да съдържа символи, които представляват HTML тагове, например `'&lt;p&gt;'|stripHtml` се преобразува в `<p>`. Никога не извеждайте получения текст с `|noescape`, тъй като това може да доведе до уязвимост на сигурността.


substr(int offset, int length = null) .[filter]
-----------------------------------------------
substr(int $offset, ?int $length=null) .[filter]
------------------------------------------------
Извлича част от низ. Този филтър е заменен с филтър за [парчета |#slice].

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


translate(string message, ...args) .[filter]
--------------------------------------------
translate(string $message, ...$args) .[filter]
----------------------------------------------
Той превежда изрази на други езици. За да направите филтъра достъпен, трябва да настроите [преводач |develop#TranslatorExtension]. Можете също така да използвате [таговете за превод |tags#Translation].

```latte
Expand All @@ -825,8 +825,8 @@ translate(string message, ...args) .[filter]
```


trim(string charlist = " \t\n\r\0\x0B\u{A0}") .[filter]
-------------------------------------------------------
trim(string $charlist=" \t\n\r\0\x0B\u{A0}") .[filter]
------------------------------------------------------
Премахване на водещи и завършващи символи, по подразбиране бяло пространство.

```latte
Expand All @@ -835,7 +835,7 @@ trim(string charlist = " \t\n\r\0\x0B\u{A0}") .[filter]
```


truncate(int length, string append = '…') .[filter]
truncate(int $length, string $append='…') .[filter]
---------------------------------------------------
Съкращава даден низ до максимално зададената дължина, но се опитва да запази цели думи. Ако низът е съкратен, той добавя елипса в края (това може да се промени с втория параметър).

Expand Down
Loading

0 comments on commit ba24c4e

Please sign in to comment.