fenom/docs/mods/truncate.md

22 lines
1.5 KiB
Markdown
Raw Normal View History

2013-03-15 01:12:23 +04:00
Modifier truncate [RU]
=======================
2013-02-09 10:59:08 +04:00
Обрезает строку до указанной длины. Может обрезать как ровно по символу так и завершивемогуся слову, где итоговоя строка не привыет указанной длины.
```smarty
{$long_string|truncate:$length:$etc:$by_words:$middle}
2013-02-09 10:59:08 +04:00
```
* `$length` обязательный параметр, указывающий максимальную длину выводимой сроки
* `$etc`, по умолчанию `...`, содержащий строку которой будет заменены "лишние" символы.
* `$by_word`, по умолчанию **FALSE**. Флаг указывает модификатору не разбивать слово, а найти ближайший (в меньшую строну) пробельный символ, после которого строка буде обрезана
2013-02-09 10:59:08 +04:00
* `$middle`, по умочанию **FALSE**. Включенный флаг, который указывает, что "лишние" данные нужно вырезать из середины строки, а не из конца.
```smarty
{var $str = "very very long string"}
{$str|truncate:10:" read more..."} output: very very read more...
{$str|truncate:5:" ... ":true:true} output: very ... string
```
Модификатор работает отлично с UTF8 и не требует расширения `mbstring`