Строковые фильтры

Search…
Строковые фильтры
Строковые фильтры используются для управления выходными данными и переменными строкового типа.
append
Добавляет символы в строку.
Пример:
1
{{ 'sales' | append: '.jpg' }}
Copied!
Вывод
1
sales.jpg
Copied!
capitalize
Делает первую букву каждого слова строки прописной
Пример:
1
{{ 'capitalize me' | capitalize }}
Copied!
Вывод
1
Capitalize Me
Copied!
downcase
Преобразует строку в нижний регистр.
Пример:
1
{{ 'UPPERCASE' | downcase }}
Copied!
Вывод
1
uppercase
Copied!
prepend
Добавляет символы в строку.
Пример:
1
{{ 'sale' | prepend: 'Made a great ' }}
Copied!
Вывод
1
Made a great sale
Copied!
delete
Удаляет все вхождения подстроки из строки.
Пример:
1
{{ "Hello, world. Goodbye, world." | remove: "world" }}
Copied!
Вывод
1
Hello, . Goodbye, .
Copied!
remove_first
Удаляет только первое вхождение подстроки из строки.
Пример:
1
{{ "Hello, world. Goodbye, world." | remove_first: "world" }}
Copied!
Вывод
1
Hello, . Goodbye, world.
Copied!
replace
Заменяет все вхождения строки подстрокой.
Пример:
1
<!-- product.title = "Awesome Shoes" -->
2
{{ product.title | replace: 'Awesome', 'Mega' }}
Copied!
Вывод
1
Mega Shoes
Copied!
replace_first
Заменяет первое вхождение строки подстрокой.
Пример:
1
<!-- product.title = "Awesome Awesome Shoes" -->
2
{{ product.title | replace_first: 'Awesome', 'Mega' }}
Copied!
Вывод
1
Mega Awesome Shoes
Copied!
slice
sliceФильтр возвращает подстроку, начиная с указанным индексом. Необязательный второй параметр может быть передан для указания длины подстроки. Если второй параметр не указан, будет возвращена подстрока из одного символа.
Пример:
1
{{ "hello" | slice: 0 }}
2
{{ "hello" | slice: 1 }}
3
{{ "hello" | slice: 1, 3 }}
Copied!
Вывод
1
h
2
e
3
ell
Copied!
Если переданный индекс отрицателен, он считается от конца строки.
Пример:
1
{{ "hello" | slice: -3, 2  }}
Copied!
Вывод
1
ll
Copied!
split
split фильтр разбивает строку на подстроки. Параметр фильтра используется в качестве разделителя для разделения строки на массив. Вы можете выводить различные части массива, используя фильтры массива .
Пример:
1
{% assign words = "Hi, how are you today?" | split: ' ' %}
2
​
3
{% for word in words %}
4
{{ word }}
5
{% endfor %}
Copied!
Вывод
1
Hi,
2
how
3
are
4
you
5
today?
Copied!
strip
Удаляет табуляции, пробелы и символы новой строки (все пробелы) с левой и правой стороны строки.
Пример:
1
{{ '   too many spaces      ' | strip }}
Copied!
Вывод
1
too many spaces
Copied!
lstrip
Удаляет табуляции, пробелы и символы новой строки (все пробелы) с левой стороны строки.
Пример:
1
{{ '   too many spaces           ' | lstrip }}
Copied!
Вывод
1
<!-- Highlight to see the empty spaces to the right of the string -->
2
too many spaces           
Copied!
rstrip
Удаляет табуляции, пробелы и символы новой строки (все пробелы) с правой стороны строки.
Пример:
1
{{ '              too many spaces      ' | rstrip }}
Copied!
Вывод
1
<!-- Notice the empty spaces to the left of the string -->
2
              too many spaces
Copied!
truncate
Усекает строку до количества символов, переданных в качестве первого параметра. Многоточие (...) добавляется к усеченной строке.
Пример:
1
{{ "The cat came back the very next day" | truncate: 13 }}
Copied!
Вывод
1
The cat ca...
Copied!
Пользовательский многоточие
truncateпринимает необязательный второй параметр, который задает последовательность символов, добавляемых к усеченной строке. По умолчанию это многоточие (...), но вы можете указать другую последовательность.
Длина второго параметра учитывается в количестве символов, указанных в первом параметре. Например, если вы хотите обрезать строку до 10 символов и использовать 3-символьный многоточие, используйте 13 для первого параметра truncate, поскольку многоточие считается как 3 символа.
Пример:
1
{{ "ABCDEFGHIJKLMNOPQRSTUVWXYZ" | truncate: 18, ", and so on" }}
Copied!
Вывод
1
ABCDEFG, and so on
Copied!
Нет многоточия
Вы можете усечь точное количество символов, указанное в первом параметре, и не показывать завершающие символы, передав пустую строку в качестве второго параметра:
Пример:
1
{{ "I'm a little teapot, short and stout." | truncate: 15, "" }}
Copied!
Вывод
1
I'm a little te
Copied!
truncatewords
Усекает строку до количества слов, переданных в качестве первого параметра. Многоточие (...) добавляется к усеченной строке.
вход
1
{{ "The cat came back the very next day" | truncatewords: 4 }}
Copied!
Вывод
1
The cat came back...
Copied!
Пользовательский многоточие
truncatewordsпринимает необязательный второй параметр, который задает последовательность символов, добавляемых к усеченной строке. По умолчанию это многоточие (...), но вы можете указать другую последовательность.
Пример:
1
{{ "The cat came back the very next day" | truncatewords: 4, "--" }}
Copied!
Вывод
1
The cat came back--
Copied!
Нет многоточия
Вы можете избежать показа завершающих символов, передав пустую строку в качестве второго параметра:
Пример:
1
{{ "The cat came back the very next day" | truncatewords: 4, "" }}
Copied!
Вывод
1
The cat came back
Copied!
upcase
Преобразует строку в верхний регистр.
Пример:
1
{{ 'i want this to be uppercase' | upcase }}
Copied!
Вывод
1
I WANT THIS TO BE UPPERCASE
Copied!
reverse
reverse не может использоваться напрямую со строкой, но вы можете разбить строку на массив, обратить массив и вернуться к нему, связав вместе другие фильтры массивов:
Пример:
1
{{ "Ground control to Major Tom." | split: "" | reverse | join: "" }}
Copied!
Вывод
1
.moT rojaM ot lortnoc dnuorG
Copied!