Tablice
First
Pobiera pierwszy element z tablicy.
Zwracany typ: object
0 1 2 |
{{ productdetails.Product.Images |First |Img }} |
Last
Pobiera ostatni element z tablicy.
Zwracany typ: object
0 1 2 |
{{ productdetails.Product.Images |Last|Img }} |
Skip
Zwraca tabelę, która nie zawiera początkowych wierszy z tabeli wejściowej. Omija określoną liczbę wierszy. Liczba wierszy do ominięcia przekazana w parametrze.
Parametry: int cnt
Zwracany typ: object[] (tablica)
0 1 2 3 4 5 6 7 8 9 10 11 12 13 |
{% assign koloryTekst = 'biały, czarny, zielony, czerwony, niebieski, żółty' %} {% assign kolory = koloryTekst |Split: ',' %} Wszystkie elementy {% for kolor in kolory -%} {{ kolor }}{% endfor -%} {% assign kolory = kolory |Skip:3 %} Pomiń 3 pierwsze wiersze {% for kolor in kolory -%} {{ kolor }} {% endfor -%} |
Powyższy przykład zwróci wszystkie elementy:
0 1 2 3 4 5 6 7 8 9 10 11 12 13 |
Wszystkie elementy biały czarny zielony czerwony niebieski żółty Pomiń 3 pierwsze wiersze czerwony niebieski żółty |
Take
Zwraca tabelę, która zawiera tylko określoną liczbę początkowych wierszy z tabeli wejściowej.
Parametry: int cnt.
Zwracany typ object[] (tablica).
0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
{% assign koloryTekst = 'biały, czarny, zielony, czerwony, niebieski, żółty' %} {% assign kolory = koloryTekst |Split: ',' %} Wszystkie elementy {% for kolor in kolory -%} {{ kolor }} {% endfor -%} {% assign kolory = kolory |Take:3 %} Pobierz tylko 3 pierwsze wiersze {% for kolor in kolory -%} {{ kolor }} {% endfor -%} |
Powyższy przykład zwróci wszystkie elementy:
0 1 2 3 4 5 6 7 8 9 10 11 12 13 |
Wszystkie elementy biały czarny zielony czerwony niebieski żółty Pobierz tylko 3 pierwsze wiersze biały czarny zielony |
Sort
Sortuje elementy w tablicy według wskazanego pola (parametr).
Parametry: string property = null
0 1 2 3 |
{% for a in productdetails.Product.Attachments |Sort:'Name' %} Nazwa: {{ a.Name }} |
Reverse
Odwraca kolejność elementów w tablicy.
Zwracany typ object[] (tablica).
0 1 2 3 4 5 6 7 8 9 |
{% assign koloryTekst = 'biały, czarny, zielony, czerwony, niebieski, żółty' %} {% assign kolory = koloryTekst |Split: ', ' %} {% assign kolory = kolory |Reverse %} Wszystkie elementy w odwróconej kolejności {% for kolor in kolory -%} {{ kolor }} {% endfor -%} |
Powyższy przykład zwróci wszystkie elementy w odwróconej kolejności
0 1 2 3 4 5 6 7 8 |
Wszystkie elementy w odwróconej kolejności żółty niebieski czerwony zielony czarny biały |
Randomize
Zwraca tabelę, w której kolejność elementów jest ustawiona w sposób losowy.
Zwracany typ object[] (tablica).
0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
{% assign koloryTekst = 'biały, czarny, zielony, czerwony, niebieski, żółty' %} {% assign kolory = koloryTekst |Split: ', ' %} {% assign kolory = kolory |Randomize %} Wszystkie elementy w losowej kolejności {% for kolor in kolory -%} {{ kolor }} {% endfor -%} {% comment %} {% assign losowyObrazek = productdetails.Product.Images | Randomize %} Pierwszy losowy obrazek na towarze {{losowyObrazek | First |Img }} {% endcomment %} |
Powyższy przykład może zwrócić wszystkie elementy w losowej kolejności
0 1 2 3 4 5 6 7 |
czerwony niebieski biały żółty czarny zielony |
Join
Łączy elementy tablicy w ciąg znaków wstawiając pomiędzy te elementy przekazany parametr.
Parametry: string glue = ” „.
Zwracany typ string.
0 1 2 3 |
Właściwości czasowe towaru {{ productdetails.Product.Flags |Map:'Text' | Join: ', ' }} |
Powyższy przykład może zwrócić właściwości czasowe towaru. (Zwracany zakres wartości zależy od ustawień w sklepie, lub na towarze).
0 1 2 3 |
Nowość, Promocja, Towar z gazetki, Towar polecany, Wyprzedaż, Superjakość, Supercena, Najlepiej oceniany, Rekomendacja sprzedawcy |
Map
Zwraca tablicę składającą się z wartości elementów kolekcji wejściowej dla wskazanej właściwości. Właściwość kolekcji przekazana w parametrze.
Parametry: string property.
Zwracany typ object[] (tablica).
0 1 2 |
{{ productdetails.Product.Flags |Map:'Text' |Join:', ' }} |
Powyższy przykład może zwrócić właściwości czasowe towaru. (Zwracany zakres wartości zależy od ustawień w sklepie, lub na towarze).
0 1 2 3 |
Nowość, Promocja, Towar z gazetki, Towar polecany, Wyprzedaż, Superjakość, Supercena, Najlepiej oceniany, Rekomendacja sprzedawcy |
0 1 2 |
{{ config.Languages |Map:'Name' |Join:', ' }} |
Powyższy przykład może zwrócić
0 1 2 |
polski, Deutsch, français |
Size (działanie na tablicach)
Zwraca liczbę elementów w tablicy (lub długość tekstu).
Zwracany typ int.
0 1 2 |
Liczba obrazków dla towaru{{ productdetails.Product.Images |Size }} |
Uniq
Zwraca unikatowe elementy tablicy (usuwa duplikaty).
Zwracany typ object[] (tablica).
0 1 2 3 4 5 6 |
{% assign kolory = "czarny,biały,niebieski,czarny,niebieski" | Split: ',' -%} {% assign unikatoweKolory = kolory | Uniq -%} {% for kolor in unikatoweKolory -%} {{kolor}} {% endfor -%} |
Powyższy przykład może zwrócić
0 1 2 |
czarny biały niebieski |
Tekstowe
Format
Formatuje tekst zgodnie z wartościami przekazanymi w poszczególnych parametrach.
Parametry: object p1, object p2 = null, object p3 = null, object p4 = null, object p5 = null, object p6 = null, object p7 = null, object p8 = null, object p9 = null, object p10 = null
Zwracany typ string.
0 1 2 3 |
{% assign cenaWaluta = 'Cena: {0}, waluta {1}'-%} {{ cenaWaluta | Format:'25.00', 'PLN' }} |
Powyższy przykład zwróci
0 1 2 |
Cena: 25.00, waluta PLN |
Append
Dodaje dodatkowy tekst do tekstu wejściowego. Dodatkowy tekst przezywany w parametrze.
Dla tekstu wejściowego == null filtr zwraca zawsze null.
Parametry: string @string.
Zwracany typ string.
0 1 2 3 4 |
{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %} {% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %} {{ tekst1 |Append: tekst2 }} |
Powyższy przykład zwróci
0 1 2 3 |
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Litwo! Ojczyzno moja! Ty jesteś jak zdrowie. |
Prepend
Dodaje przed tekstem wejściowym dodatkowy tekst. Dodatkowy tekst przezywany w parametrze.
Dla tekstu wejściowego == null filtr zwraca zawsze null.
Parametry: string @string.
Zwracany typ string.
0 1 2 3 4 |
{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %} {% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %} {{ tekst1 |Prepend: tekst2 }} |
Powyższy przykład zwróci
0 1 2 3 |
Litwo! Ojczyzno moja! Ty jesteś jak zdrowie. Lorem ipsum dolor sit amet, consectetur adipiscing elit. |
Capitalize
Konwertuje tekst. Każde słowo w tekście zaczyna z dużej litery.
Zwracany typ string.
0 1 2 3 |
{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %} {{ tekst1 |Capitalize }} |
Downcase
Konwertuje tekst. Cały tekst (każdą literę) zamienia na tekst pisany małymi literami.
Zwracany typ string.
0 1 2 3 |
{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %} {{ tekst1 | Downcase }} |
Upcase
Konwertuje tekst. Cały tekst (każdą literę) zamienia na tekst pisany dużymi literami.
Zwracany typ string.
0 1 2 3 |
{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %} {{ tekst1 |Upcase}} |
Remove
Usuwa z tekstu wejściowego fragment tekstu przekazany w parametrze.
Parametry: string @string.
Zwracany typ string.
0 1 2 3 |
{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %} {{ tekst1 |Remove:'ip' }} |
RemoveFirst
Usuwa z tekstu wejściowego pierwsze wystąpienie fragmentu tekstu przekazanego w parametrze.
Parametry: string @string.
Zwracany typ string.
0 1 2 3 |
{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %} {{ tekst1 |RemoveFirst:'ip' }} |
Replace
Zamienia w tekście wejściowym szukany fragment tekstu innym tekstem (tekst zamienny). Szukany fragment tekstu, tekst zamienny przekazane w parametrach. Parametry przyjmują wyrażenia regularne. Jeśli chcemy wyszukać znak specjalny i użyć go jak znaku, a nie części wyrażenia regularnego należy go poprzedzić ukośnikiem \.
Parametry: string @string, string replacement = „”.
Zwracany typ string.
0 1 2 3 4 5 6 7 |
{% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %} {{ tekst2 |Replace:'!','.' }} {% assign waga = '31.53kg' %} {{ waga |Replace:'\.',',' }} {% assign spacje = ' Litwo! Ojczyzno moja! Ty jesteś jak zdrowie. ' %} {{ spacje |Replace:'^\s+|\s+$','' }} |
ReplaceFirst
W tekście wejściowym zamienia pierwsze wystąpienie szukanego fragmentu tekstu innym tekstem (tekst zamienny). Szukany fragment tekstu, tekst zamienny przekazane w parametrach. Parametry przyjmują wyrażenia regularne. Jeśli chcemy wyszukać znak specjalny i użyć go jak znaku, a nie części wyrażenia regularnego należy go poprzedzić ukośnikiem \.
Parametry: string @string, string replacement = „”.
Zwracany typ string.
0 1 2 3 4 5 |
{% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %} {{ tekst 2 |ReplaceFirst:'!','.' }} {% assign waga = '31.53kg' %} {{ waga |Replace:'\.',',' }} |
Size
(działanie na tekstach)
Zwraca długość tekstu (liczba znaków).
Zwracany typ int.
0 1 2 3 4 5 6 |
Długość opisu towaru {{ productdetails.Product.Description |Size }} Liczba znaków w cenie towaru {{ productdetails.Product.Price |ToString |Size }} |
Slice
Zwraca fragment z tekstu wejściowego dla podanej pozycji początkowej oraz długości.
Pozycja początkowa, długość przekazane w parametrach.
W przypadku, gdy parametr z pozycją początkową jest ujemny, pozycja początkowa liczona jest od od końca tekstu.
Parametry: int start, int len = 1.
Zwracany typ string.
0 1 2 3 4 5 6 7 |
{% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %} {{ tekst2 |Slice:0 }} {{ tekst2 |Slice:1 }} {{ tekst2 |Slice:0,20 }} {{ tekst2 |Slice: - 1 }} {{ tekst2 |Slice: - 20,10 }} |
Powyższy przykład zwróci
0 1 2 3 4 5 6 |
L i Litwo! Ojczyzno moja . jesteś jak |
Split
Tworzy z tekstu wejściowego tablicę, gdzie każdy element tablicy stanowi fragment tekstu rozdzielony przez podany wzorzec. Wzorzec przekazany w parametrze.
Parametry: string pattern.
Zwracany typ string[] (tablica).
0 1 2 3 4 5 6 7 8 9 10 11 |
{% assign koloryTekst = 'biały, czarny, zielony, czerwony, niebieski, żółty' %} {% assign kolory = koloryTekst |Split:', ' %} Pierwszy element {{ kolory[0] }} Wszystkie elementy {% for kolor in kolory - %} {{ kolor }} {% endfor - %} |
Powyższy przykład zwróci pierwszy element
0 1 2 3 4 5 6 7 8 9 10 |
biały Wszystkie elementy biały czarny zielony czerwony niebieski żółty |
StripHtml
Usuwa wszystkie tagi HTML z tekstu wejściowego.
Zwracany typ string.
0 1 2 |
{{ productdetails.Product.Description |StripHtml }} |
StripNewlines
Usuwa wszystkie znaki nowej linii, podziały wiersza z tekstu wejściowego.
Zwracany typ string.
0 1 2 |
{{ productdetails.Product.Description |StripNewlines }} |
NewlineToBr
Wstawia tag HTML przed każdym znakiem nowej linii w tekście wejściowym.
Zwracany typ string.
0 1 2 |
{{ productdetails.Product.Description |NewlineToBr }} |
Truncate
Obcina tekst wejściowy do podanej liczby znaków dodając na końcu wielokropek, lub inny tekst obcinający. Tekst obcinający wliczony jest w liczbę znaków. Liczba znaków, tekst obcinający przekazane w parametrach.
Parametry: int length = 50, string truncateString = „…”. Zwracany typ string.
0 1 2 |
{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %} {% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %} {{ tekst1 |Truncate }} {{ tekst2 |Truncate:25,'(...)' }} |
Powyższy przykład zwróci
0 1 2 |
Lorem ipsum dolor sit amet, consectetur adipisc... Litwo! Ojczyzno moj (...) |
TruncateWords
Obcina tekst wejściowy do podanej liczby wyrazów dodając na końcu wielokropek, lub inny tekst obcinający. Liczba wyrazów, tekst obcinający przekazane w parametrach.
Parametry: int words = 15, string truncateString = „…” Zwracany typ string.
0 1 2 |
{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %} {% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %} {{ tekst1 |TruncateWords }} {{ tekst2 |TruncateWords:3,' (...)' }} |
Powyższy przykład zwróci
0 1 2 |
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Litwo! Ojczyzno moja! (...) |
Times (działanie na tekstach)
Powtarza tekst wielokrotnie. Liczba powtórzeń przekazywana w parametrze.
Parametry: int operand.
Zwracany typ string.
0 1 2 3 4 |
{% assign kropka = '.' %} {% assign liczbapowtorzen = 3 %} Przykładowy tekst zakończony kropkami{{ kropka|Times: liczbapowtorzen }} |
Liczbowe, Matematyczne
Plus
Dodawanie.
Parametry: object operand.
Zwracany typ numeryczny (int, decimal). Zwracany typ zgodny z typem obiektu, na którym następuje działanie.
0 1 2 3 4 |
{% assign liczba1 = 9 %} {% assign liczba2 = 2 %} Wynik: {{ liczba1 | Plus:liczba2 }} |
Uwaga. Dla obiektu wejściowego o typie string filtr
Plus łączy wartość obiektu oraz wartość parametru w ciąg znaków. Działa nie podobne jak filtr Append. Zwracany typ string.
Minus
Odejmowanie.
Parametry: object operand.
Zwracany typ numeryczny (int, decimal). Zwracany typ zgodny z typem obiektu, na którym następuje działanie.
0 1 2 3 4 |
{% assign liczba1 = 9 %} {% assign liczba2 = 3 %} Wynik: {{ liczba1 |Minus:liczba2 }} |
Times (działanie na liczbach)
Mnożenie.
Parametry: object operand.
Zwracany typ numeryczny (int, decimal). Zwracany typ zgodny z typem obiektu, na którym następuje działanie.
0 1 2 3 4 |
{% assign liczba1 = 9.01 %} {% assign liczba2 = 2 %} Wynik: {{ liczba1 |Times:liczba2 }} |
DividedBy
Dzielenie.
Parametry: object operand.
Zwracany typ numeryczny (int, decimal). Zwracany typ zgodny z typem obiektu, na którym następuje działanie.
0 1 2 3 4 |
{% assign liczba1 = 9 %} {% assign liczba2 = 3 %} Wynik:{{ liczba1 |DividedBy:liczba2 }} |
Modulo
Reszta z dzielenia.
Parametry: object operand.
Zwracany typ numeryczny (int, decimal). Zwracany typ zgodny z typem obiektu, na którym następuje działanie.
0 1 2 3 4 |
{% assign liczba1 = 9.01 %} {% assign liczba2 = 2 %} Wynik:{{ liczba1 |Modulo:liczba2 }} |
Normalize
Formatuje liczbę. Usuwa „zbędne” zera w części ułamkowej liczby wejściowej.
Liczba wejściowa o typie decimal.
Zwracany typ decimal.
0 1 2 3 |
Cena: {{ productdetails.Product.Price }} Cena: {{ productdetails.Product.Price |Normalize }} |
Powyższy przykład może zwrócić
0 1 2 3 |
Cena: 10,00 Cena: 10 |
Floor
Zwraca największą liczbę całkowitą, która jest mniejsza lub równa wejściowej.
Liczba wejściowa o typie decimal.
Zwracany typ Int.
0 1 2 3 |
{% assign liczba = 6.05 %} Wynik:{{ liczba |Floor }} |
Powyższy przykład może zwrócić
0 1 2 |
Wynik:6 |
Ceil
Zwraca najmniejszą liczbę całkowitą, która jest większa lub równa wejściowej.
Liczba wejściowa o typie decimal.
Zwracany typ Int.
0 1 2 3 |
{% assign liczba = 6.05 %} Wynik:{{ liczba |Ceil }} |
Powyższy przykład może zwrócić
0 1 2 |
Wynik:7 |
Abs
Zwraca wartość bezwzględną z liczby
0 1 2 3 |
{% assign liczba = -6.05 %} Wynik:{{ liczba |Abs}} |
Powyższy przykład może zwrócić
0 1 2 |
Wynik:6.05 |
Round
Zaokrągla liczbę wejściową do określonej ilości miejsc po przecinku
0 1 2 3 |
{% assign liczba = 6.05687 %} Wynik:{{ liczba |Round:4 }} |
Powyższy przykład może zwrócić
0 1 2 |
Wynik:6.0569 |
Data i czas
Date
Formatuje datę i czas. Zwraca datę i czas zgodnie z formatem przekazanym w parametrze.
Filtr Date w sklepie korzysta z domyślnych ustawień dla DotLiquid. Należy korzystać z formatu daty zgodnego z konwencją .NET httpss://msdn.microsoft.com/en-us/library/8kb3ddd4(v=vs.100).aspx
Parametry: string format.
Zwracany typ string.
0 1 2 3 4 5 6 7 |
Data i czas "teraz" {{ config.Now }} Data {{ config.Now |Date:'yyyy:MM:dd' }} Czas {{ config.Now |Date:'HH:mm:ss' }} |
Powyższy przykład może zwrócić
0 1 2 3 4 5 6 7 |
Data i czas "teraz" 2016-04-18 10:32:39 Data 2016-04-18 Czas 10:32:39 |
Cena
ToPrice
Formatuje cenę do formatu wyświetlania zgodnego z kulturą dla ustawionej lokalizacji sklepu (grupowanie tysięcy, kropka czy przecinek, itd.).
Lokalizacja sklepu określa, czy sklep został zainstalowany domyślnie na rynek polski, niemiecki, itd.
Zwracany typ string.
0 1 2 3 |
Cena: {{ productdetails.Product.Price }} Cena: {{ productdetails.Product.Price |ToPrice }} |
Powyższy przykład może zwrócić dla lokalizacji na rynek polski
0 1 2 3 4 |
Cena: 2348,68 Cena: 2 348,68 (lokalizacja na rynek polski) Cena: 2.348,68 (lokalizacja na rynek niemiecki) |
HTML
Filtry, które po zastosowaniu zwracają gotowe fragmenty kodów HTML do wykorzystania na stronie.
A
Tworzy tag <a>wraz z atrybutami. Tag tworzony na podstawie obiektu Liquid. Wartości dla atrybutów tagu pobierane są z obiektu.
Zwracany typ string.
Filtr ma zastosowanie dla obiektów:
- Strona
- Grupa towarowa
- Towar
- Blog
- Tagi
Przykład użycia filtra A dla obiektów: Strona
0 1 2 3 4 5 6 7 |
Strony {{ config.DefinedPages.Home |A |H }} {{ config.Pages['6'] |A |H }} { % comment % }Strona o id = 6 {% endcomment %} {{ page.CurrentSiteNode |A |H }} {{ page.GroupNodes[0] |A |H }} {{ page.Breadcrumbs[0] |A |H }} |
Powyższy przykład może zwrócić
0 1 2 3 4 5 6 7 8 |
Strony <a href="./">Strona główna</a> <a href="profil-klienta,6">Profil klienta</a> <a href="produkty/owoce-1/banany-555,2,1024703">Banany</a> <a href="produkty/owoce-1,2,76">Owoce</a> <a href="./">Strona główna</a> |
Przykład użycia filtra A dla obiektów: Towar
0 1 2 3 4 5 |
Towary {{ productnew.Products[0] |A |H }} {{ productlist.Products[1] |A |H }} {{ productdetails.Product |A |H }} |
Powyższy przykład może zwrócić
0 1 2 3 4 5 6 |
Towary <a href="banany,3,1024703,81">Banany </a> <a href="minibanany-odrobina-wystarczy,3,1024703,82">Minibanany odrobina wystarczy</a> <a href="minibanany-odrobina-wystarczy,3,1024703,82">Minibanany odrobina wystarczy </a> |
Przykład użycia filtra A dla obiektów: Blog, Tags
0 1 2 3 4 5 6 |
Blog {{ blog.PostList.Posts[0] |A |H }} {{ blog.PostDetails |A |H }} Tags {{ config.Tags.Blog[0] |A |H }} |
Powyższy przykład może zwrócić
0 1 2 3 4 5 6 |
Blog <a href="blog-wpis-podstawowy,24,1">Blog wpis podstawowy</a> <a href="blog-wpis-podstawowy,24,1">Blog wpis podstawowy</a> Tags <a rel="tag" href="blog,23?seaBlog=Informacje">Informacje</a> |
Img
Tworzy tag <img>wraz z atrybutami. Tag tworzony na podstawie obiektu Liquid lub na podstawie tekstu z linkiem do obrazka. Wartości dla atrybutów tagu pobierane są z obiektu lub mogą być przekazane przez parametry.
Uwaga.
Tag <img> domyślnie ustawiony ma link do obrazku w atrybucie data-src. Należy zastosować funkcję skryptową, która przepisze wartość z atrybutu data-src do atrybutu src (lazy load).
0 1 2 3 4 |
Parametry: string size = 'small', string alt = null, string title = null. Dostępne wartości dla parametru size. |
Parametr size | Rozmiar zdjęcia (dłuższa krawędź) w px |
---|---|
img | 0 |
pico | 16 |
icon | 32 |
thumb | 50 |
small | 100 |
compact | 160 |
medium | 240 |
large | 480 |
grande | 600 |
master | 1920 |
Zwracany typ string.
Filtr ma zastosowanie dla obiektów:
- Towar
- Zdjęcia towaru (na szczegółach towaru)
- Producent
- Marka
- Blog (w obiekcie blog pomijany jest parametr size. Obrazki zwracane są zawsze w rozmiarze rzeczywistym).
Przykład użycia filtra Img dla obiektów: Towar, Zdjęcia towaru
0 1 2 3 4 5 6 |
Lista towarów {{ productlist.Products[1] |Img |H }} {{ productlist.Products[1] |Img:'medium','Świeże banany, Kraków' |H }} Towar (szczegóły) {{ productdetails.Product |Img:'large' |H }} {{ productdetails.Product.StockLevel.ImageUrl |Img |H }} { % comment % } Tekst z linkiem {% endcomment %} {{ productdetails.Product.Images[0] |Img |H }} |
Powyższy przykład może zwrócić
0 1 2 3 4 5 6 7 8 9 |
Lista towarów <img alt="Minibanany odrobina wystarczy" src="usr/alo.gif" data-src="img/small/59/minibanany.jpg"/> <img alt="Świeże banany, Kraków" src="usr/alo.gif" data-src="img/medium/59/minibanany.jpg"/> Towar (szczegóły) <img alt="Minibanany odrobina wystarczy" src="usr/alo.gif" data-src="img/large/59/minibanany.jpg"/> <img src="usr/alo.gif" data-src="Ima.ashx?t=wrs&Id=1"/> <img alt="" src="usr/alo.gif" data-src="img/small/59/.jpg"/> |
Przykład użycia filtra Img dla obiektów: Producent, Marka
0 1 2 3 4 5 |
Producent, Marka {{ manufacturersbrands.Manufacturers[2] |Img |H }} {{ manufacturersbrands.Manufacturers[2] |Img:'thumb','Comarch globalny dostawca IT.' |H }} {{ manufacturersbrands.Brands[3] |Img |H }} |
Powyższy przykład może zwrócić
0 1 2 3 4 5 |
Producent, Marka <img alt="Comarch" src="usr/alo.gif" data-src="img/small/160/Comarch.jpg"/> <img alt="Comarch globalny dostawca IT." src="usr/alo.gif" data-src="img/thumb/160/Comarch.jpg"/> <img alt="Comarch ALTUM" src="usr/alo.gif" data-src="img/small/92/Comarch%20ALTUM.jpg"/> |
Przykład użycia filtra Img dla obiektów: Blog
0 1 2 3 4 5 |
Blog {{ blog.LatestPosts[0] |Img |H}} {{ blog.PostList.Posts[0] |Img:'compact','Blog dla Partnera','Informacje dla Partnerów na blogu sklepu' |H}} {{ blog.PostDetails |Img |H}} |
Powyższy przykład może zwrócić
0 1 2 3 4 5 6 |
Blog <img alt="Blog wpis podstawowy" src="usr/alo.gif" data-src="Ima.ashx?t=blg&id=1"/> <img alt="Blog dla Partnera" title="Blog dla Partnera,'Informacje dla Partnerów na blogu sklepu" src="usr/alo.gif" data-src="Ima.ashx?t=blg&id=1"/> <img alt="Blog wpis podstawowy" src="usr/alo.gif" data-src="Ima.ashx?t=blg&id=1"/> |
Przykład użycia filtra Img dla tekstu z linkiem do obrazka
0 1 2 3 4 |
Tekst z linkiem do obrazka {{ productdetails.Product.StockLevel.ImageUrl |Img |H }} { % comment % } Tekst z linkiem {% endcomment %} {{ 'https://www.domena.pl/file/banner.jpg' |Img:'','atrybut alt','atrybut title' |H }} |
Powyższy przykład może zwrócić
0 1 2 3 4 |
Tekst z linkiem do obrazka <img src="usr/alo.gif" data-src="Ima.ashx?t=wrs&Id=1"/> <img alt="atrybut alt" title="atrybut title"src="usr/alo.gif" data-src="https://www.domena.pl/file/banner.jpg"/> |
Img2
Filtr Img2 zachowuje się w podobny sposób jak wyżej opisany filtr Img. Różnicą jest to, że utworzony tag <img> ma link do obrazka nie w atrybucie data-src, lecz w atrybucie data-lazy. Dodatkowo filtr Img2 pozwala na dodanie czwartego parametru raw, w którym można wpisać wszystko, np. class=”example_class” i znajdzie się to wewnątrz tagu <img>.
0 1 2 3 |
Parametry: string size = "small", string raw = null, string alt = null, string title = null |
Przykład użycia filtra Img2 na szczegółach towaru:
0 1 2 3 |
{{product.Images[0]|Img2:'large', '', 'pasek', 'obrazek'}} {{product.Images[0]|Img2:'large', 'class="open-gallery"', 'pasek', 'obrazek'}} |
Powyższy przykład może zwrócić
0 1 2 3 |
<img src="img/large/27/.jpg" alt="pasek" title="obrazek" style="opacity: 1;"> <img src="img/large/27/.jpg" alt="pasek" title="obrazek" class="open-gallery" style="opacity: 1;"> |
Pozostałe
H
Zamienia znaki specjalne na encje HTML (HTMLEncode).
Zwracany typ string.
0 1 2 3 4 |
{% assign tekst2HTML = '<p>Litwo! <b>Ojczyzno moja!</b> Ty jesteś jak zdrowie.</p>' %} Tekst z encjami HTML {{ tekst2HTML |H }} |
Powyższy przykład zwróci
0 1 2 |
Tekst z encjami HTML <p>Litwo! <b>Ojczyzno moja!</b> Ty jesteś jak zdrowie.</p> |
Escape
Alias dla filtra H.
EscapeUri
Zamienia znaki spoza zakresu ASCII na format zgodny z ASCII.
Zwracany typ string.
0 1 2 3 4 |
{% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %} Link użytkownika {{ '<'|H }}a href="/?tekst={{ tekst2 | EscapeUri }}" (...) |
Powyższy przykład zwróci
0 1 2 3 |
Link użytkownika <a href="/?tekst=Litwo!%20Ojczyzno%20moja!%20Ty%20jeste%C5%9B%20jak%20zdrowie." (...) |
UnEscapeUri
Filtr przeciwstawny do filtra EscapeUri.
Zwracany typ string.
ToString
Konwertuje obiekt do typu string.
Zwracany typ string.
0 1 2 |
{% assign tekst2 = ' Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' -%} {% assign liczba = 3 -%} Liczba i tekst: {{ liczba |ToString |Append: tekst2 }} |
Powyższy przykład zwróci
0 1 2 |
Liczba i tekst: 3 Litwo! Ojczyzno moja! Ty jesteś jak zdrowie. |
ToInt
Konwertuje obiekt do typu int.
Zwracany typ int.
0 1 2 3 4 |
{% assign tekstLiczba1 = '9'- %} {% assign liczba1 = tekstLiczba1 |ToInt- %} ToInt: {{ liczba1 }} | {{ liczba1 |Minus:4 }} |
Powyższy przykład zwróci
0 1 2 |
ToInt: 9 | 5 |
ToNum
Konwertuje obiekt zgodnie z formatem dla kultury Invariant. W zależności od lokalizacji sklepu liczby, daty wyświetlane są zgodnie z kulturą dla tej lokalizacji. Kultura Invariant zapewnia zawsze taki sam format obiektu.
Zwracany typ string.
0 1 2 3 4 5 |
liczba: {{ 1239,01 }} liczba (Invariant) : {{ 1239,01|ToNum }} data: {{config.Now }} data (Invariant) {{config.Now|ToNum }} |
Powyższy przykład może zwrócić
0 1 2 3 4 5 |
liczba: 1239,01 liczba (Invariant) : 1239.01 data: 29.04.2016 14:45:24 data (Invariant) 04/29/2016 14:45:24 |
ToTimeSpan
Konwertuje tekst do typu TimeSpan zgodnie z formatem dla kultury Invariant.
Zwracany typ TimeSpan.
0 1 2 |
TimeSpan: {{ '509.07:01:01'|ToTimeSpan }} |
DEBUG
Wyświetla obiekty globalne i lokalne wraz z jego właściwościami i odpowiadającycmi im wartościami.
Przykład wyświetlenia obiektu customer z filtrem DEBUG
0 1 2 3 4 5 6 7 8 9 |
<fieldset> <legend>DEBUG customer</legend> <pre>{{ customer | DEBUG }}</pre> </fieldset> </fieldset> "Email" : "", "Authenticated" : false, "Currency" : "PLN",(...) |
Podgląd stron w czasie rzeczywistymCzy ten artykuł był pomocny?