Διαθέσιμα φίλτρα Liquid

Άρθρο
08/15/2023

Τα φίλτρα Liquid χρησιμοποιούνται για να τροποποιήσετε το αποτέλεσμα συμβολοσειρών, αριθμών, μεταβλητών και αντικειμένων. Διαχωρίζονται από την τιμή στην οποία αυτά εφαρμόζονται με ένα |.

{{ 'hal 9000' | upcase }} 

Ορισμένα φίλτρα δέχονται παραμέτρους. Τα φίλτρα μπορούν επίσης να συνδυαστούν και εφαρμόζονται από τα αριστερά προς τα δεξιά.

{{ 2 | times: 2 | minus: 1 }} <!-- Output: 3 -->

{{ "Hello, " | append: user.firstname }} <!-- Output: Hello, Dave -->

Η παρακάτω ενότητα περιγράφει διάφορα φίλτρα.

Φίλτρα πίνακα

Τα φίλτρα πίνακα χρησιμοποιούνται για να εργαστείτε με πίνακες.

δέσμη

Χωρίζει έναν πίνακα σε πολλούς πίνακες ενός δεδομένου μεγέθους.

Κώδικας

{% assign batches = entityview.records | batch: 2 %}

{% for batch in batches %}

<ul>

{% for item in batch %}

<li>{{ item.fullname }}</li>

{% endfor %}

</ul>

{% endfor %}

Έξοδος

<ul>

<li>John Smith</li>

<li>Dave Thomas</li>

</ul>

<ul>

<li>Jake Johnson</li>

<li>Jack Robinson</li>

</ul>

concat

Συνενώνει δύο πίνακες σε ένα νέο πίνακα.

Με ένα μεμονωμένο στοιχείο ως παράμετρο, το concat επιστρέφει έναν νέο πίνακα που αποτελείται από τον αρχικό πίνακα, με το δεδομένο στοιχείο ως το τελευταίο στοιχείο.

Κώδικας

Group #1: {{ group1 | join: ', ' }}

Group #2: {{ group2 | join: ', ' }}

Group #1 + Group #2: {{ group1 | concat: group2 | join: ', ' }}

Έξοδος

Group #1: John, Pete, Hannah

Group #2: Joan, Bill

Group #1 + Group #2: John, Pete, Hannah, Joan, Bill

εκτός από

Επιλέξτε όλα τα αντικείμενα σε έναν πίνακα όπου ένα συγκεκριμένο χαρακτηριστικό δεν έχει μια συγκεκριμένη τιμή. (Αυτό είναι το αντίστροφο του όπου.)

Κώδικας

{% assign redmond = entityview.records | except: 'address1_city', 'Redmond' %}

{% for item in redmond %}

{{ item.fullname }}

{% endfor %}

Έξοδος

Jack Robinson

Πρώτη

Επιστρέφει το πρώτο στοιχείο του πίνακα.

Το πρώτο μπορεί επίσης να χρησιμοποιηθεί με μια ιδιαίτερη σημειογραφία με τελείες, στις περιπτώσεις όπου χρειάζεται να χρησιμοποιηθεί μέσα σε μια ετικέτα.

Κώδικας

{% assign words = This is a run of text | split:   %}

{{ words | first }}

{% if words.first == This %}

The first word is This.

{% endif %}

Έξοδος

This

The first word is This.

group_by

Ομαδοποιεί τα στοιχεία σε έναν πίνακα από ένα συγκεκριμένο χαρακτηριστικό.

Κώδικας

{% assign groups = entityview.records | group_by: 'address1_city' %}

{% for group in groups %}

{{ group.key }}:

{% for item in group.items %}

{{ item.fullname }}

{% endfor %}

{% endfor %}

Έξοδος

Redmond:

John Smith

Dave Thomas

Jake Johnson

New York:

Jack Robinson

join

Συνδέει τα στοιχεία ενός πίνακα με το χαρακτήρα που διαβιβάστηκε ως παράμετρος. Το αποτέλεσμα είναι μία μόνο συμβολοσειρά.

Κώδικας

{% assign words = This is a run of text | split:   %}

{{ words | join: ,  }}

Έξοδος

This, is, a, run, of, text

Τελευταία

Επιστρέφει το τελευταίο στοιχείο του πίνακα.

Το τελευταίο μπορεί επίσης να χρησιμοποιηθεί με μια ιδιαίτερη σημειογραφία με τελείες, στις περιπτώσεις όπου χρειάζεται να χρησιμοποιηθεί μέσα σε μια ετικέτα.

Κώδικας

{% assign words = This is a run of text | split:   -%}

{{ words | last }}

{% if words.last == text -%}

The last word is text.

{% endif -%}

Έξοδος

text

The last word is text.

order_by

Επιστρέφει τα στοιχεία ενός πίνακα ταξινομημένα κατά ένα συγκεκριμένο χαρακτηριστικό των στοιχείων του πίνακα.

Προαιρετικά, μπορείτε να παρέχετε το desc ως δεύτερη παράμετρο για την ταξινόμηση των στοιχείων σε φθίνουσα σειρά, αντί για αύξουσα.

Κώδικας

{{ entityview.records | order_by: 'fullname' | join: ', ' }}

{{ entityview.records | order_by: 'fullname', 'desc' | join: ', ' }}

Έξοδος

Dave Thomas, Jack Robinson, Jake Johnson, John Smith

John Smith, Jake Johnson, Jack Robinson, Dave Thomas

random

Επιστρέφει ένα τυχαία επιλεγμένο στοιχείο από τον πίνακα.

Κώδικας

{{ group1 | join: ', ' }}

{{ group1 | random }}

Έξοδος

John, Pete, Hannah

Pete

select

Επιλέγει την τιμή ενός δεδομένου χαρακτηριστικού για κάθε στοιχείο ενός πίνακα και επιστρέφει αυτές τις τιμές με τη μορφή πίνακα.

Κώδικας

{{ entityview.records | select: 'address1_city' | join: ', ' }}

Έξοδος

Redmond, New York

shuffle

Εφαρμόζεται σε έναν πίνακα, αποδίδει έναν νέο πίνακα με τα ίδια στοιχεία, με τυχαία σειρά.

Κώδικας

{{ group1 | join: ', ' }}

{{ group1 | shuffle | join: ', ' }}

Έξοδος

John, Pete, Hannah

Hannah, John, Pete

size

Αποδίδει τον αριθμό των στοιχείων σε έναν πίνακα.

Το μέγεθος μπορεί επίσης να χρησιμοποιηθεί με μια ιδιαίτερη σημειογραφία με τελείες, στις περιπτώσεις όπου χρειάζεται να χρησιμοποιηθεί μέσα σε μια ετικέτα.

Κώδικας

{% assign words = This is a run of text | split:   -%}

{{ words | size }}

{% if words.size == 6 -%}

The text contains 6 words.

{% endif -%}

Έξοδος

6

The text contains 6 words.

skip

Παραλείπει ένα δεδομένο πλήθος στοιχείων σε έναν πίνακα και επιστρέφει το υπόλοιπο.

Κώδικας

{% assign words = This is a run of text | split:   %}

{{ words | skip: 3 | join: ', ' }}

Έξοδος

run, of, text

take

Λαμβάνει ένα δεδομένο πλήθος στοιχείων από τον πίνακα και επιστρέφει τα στοιχεία που λαμβάνονται.

Κώδικας

{% assign words = This is a run of text | split:   %}

{{ words | take: 3 | join: ', ' }}

Έξοδος


This, is, a

then_by

Προσθέτει επιπλέον μετέπειτα ταξινόμηση σε έναν πίνακα που έχει ήδη ταξινομηθεί κατά παραγγελία.

Κώδικας

{{ entityview.records | order_by: 'address1_city' | then_by: 'fullname' | join: ', ' }}

{{ entityview.records | order_by: 'address1_city' | then_by: 'fullname', 'desc' | join: ', ' }}

Έξοδος

Dave Thomas, Jack Robinson, Jake Johnson, John Smith

John Smith, Jake Johnson, Jack Robinson, Dave Thomas

όπου

Επιλέξτε όλα τα αντικείμενα σε έναν πίνακα όπου ένα συγκεκριμένο χαρακτηριστικό έχει μια συγκεκριμένη τιμή.

Κώδικας

{% assign redmond = entityview.records | where: 'address1_city', 'Redmond' %}

{% for item in redmond %}

{{ item.fullname }}

{% endfor %}

Έξοδος

John Smith

Dave Thomas

Jake Johnson

Φίλτρα ημερομηνίας

Τα φίλτρα ημερομηνίας μπορούν να χρησιμοποιηθούν για αριθμητική ημερομηνία ή για να μετατρέψετε τιμές ημερομηνίας/ώρας σε διάφορες μορφές.

ημερομηνία

Διαμορφώνει μια τιμή DateTime χρησιμοποιώντας μια συμβολοσειρά μορφής .NET.

Συμβολοσειρές ημερομηνίας και ώρας βασικής μορφής

Συμβολοσειρές ημερομηνίας και ώρας προσαρμοσμένης μορφής

Κώδικας

{{ now | date: 'g' }}

{{ now | date: 'MMMM dd, yyyy' }}

Έξοδος

5/7/2018 7:20 AM

May 07, 2018

date_add_days

Προσθέτει τον καθορισμένο αριθμό ολόκληρων και τμηματικών ημερών στην τιμή DateTime. Η παράμετρος μπορεί να είναι θετική ή αρνητική.

Κώδικας

{{ now }}

{{ now | date_add_days: 1 }}

{{ now | date_add_days: -2.5 }}

Έξοδος

5/7/2018 7:20:46 AM

5/8/2018 7:20:46 AM

5/4/2018 7:20:46 PM

date_add_hours

Προσθέτει τον καθορισμένο αριθμό ολόκληρων και τμηματικών ωρών στην τιμή DateTime. Η παράμετρος μπορεί να είναι θετική ή αρνητική.

Κώδικας

{{ now }}

{{ now | date_add_hours: 1 }}

{{ now | date_add_hours: -2.5 }}

Έξοδος

5/7/2018 7:20:46 AM

5/7/2018 8:20:46 AM

5/7/2018 4:50:46 AM

date_add_minutes

Προσθέτει τον καθορισμένο αριθμό ολόκληρων και τμηματικών λεπτών στην τιμή DateTime. Η παράμετρος μπορεί να είναι θετική ή αρνητική.

Κώδικας

{{ now }}

{{ now | date_add_minutes: 10 }}

{{ now | date_add_minutes: -2.5 }}

Έξοδος

5/7/2018 7:20:46 AM

5/7/2018 7:30:46 AM

5/7/2018 7:18:16 AM

date_add_months

Προσθέτει τον καθορισμένο αριθμό ολόκληρων και τμηματικών μηνών στην τιμή DateTime. Η παράμετρος μπορεί να είναι θετική ή αρνητική.

Κώδικας

{{ now }}

{{ now | date_add_months: 1 }}

{{ now | date_add_months: -2 }}

Έξοδος

5/7/2018 7:20:46 AM

6/7/2018 7:20:46 AM

3/7/2018 7:20:46 AM

date_add_seconds

Προσθέτει τον καθορισμένο αριθμό ολόκληρων και τμηματικών δευτερολέπτων στην τιμή DateTime. Η παράμετρος μπορεί να είναι θετική ή αρνητική.

Κώδικας

{{ now }}

{{ now | date_add_seconds: 10 }}

{{ now | date_add_seconds: -1.25 }}

Έξοδος

5/7/2018 7:20:46 AM

5/7/2018 7:20:56 AM

5/7/2018 7:20:45 AM

date_add_years

Προσθέτει τον καθορισμένο αριθμό ολόκληρων και τμηματικών ετών στην τιμή DateTime. Η παράμετρος μπορεί να είναι θετική ή αρνητική.

Κώδικας

{{ now }}

{{ now | date_add_years: 1 }}

{{ now | date_add_years: -2 }}

Έξοδος

5/7/2018 7:20:46 AM

5/7/2019 7:20:46 AM

5/7/2016 7:20:46 AM

date_to_iso8601

Διαμορφώνει μια τιμή DateTime σύμφωνα με το πρότυπο ISO 8601. Χρήσιμο κατά τη δημιουργία τροφοδοσιών Atom ή του στοιχείου HTML5 <χρόνος>.

Κώδικας

{{ now | date_to_iso8601 }}

Έξοδος

2018-05-07T07:20:46Z

date_to_rfc822

Διαμορφώνει μια τιμή DateTime σύμφωνα με το πρότυπο RFC 822. Χρήσιμο κατά τη δημιουργία τροφοδοσιών RSS.

Κώδικας

{{ now | date_to_rfc822 }}

Έξοδος

Mon, 07 May 2018 07:20:46 Z

Φίλτρα διαφυγής

Οι ακολουθίες διαφυγής παρέχουν έναν τρόπο ενσωμάτωσης ειδικών χαρακτήρων σε συμβολοσειρές χωρίς να έρχονται σε σύγκρουση με την κανονική ερμηνεία αυτών των χαρακτήρων από τη γλώσσα προγραμματισμού ή τη μορφή.

Τα παρακάτω φίλτρα διαφυγής αντικαθιστούν τους χαρακτήρες συμβολοσειράς με ακολουθίες διαφυγής ή αφαιρούν τους μη έγκυρους χαρακτήρες συμβολοσειράς ανάλογα με τον τύπο προορισμού.

escape

HTML-διαφεύγει από μια συμβολοσειρά.

Κώδικας

{{ '<p>test</p>' | escape }}

Έξοδος

&lt;p&gt;test&lt;/p&gt;

html_safe_escape

Μετατρέπει μια δεδομένη συμβολοσειρά HTML σε ένα ασφαλές τμήμα HTML.

Κώδικας

{{ '<img src="images/myimage.jpg" onerror="alert(1);">' | html_safe_escape }}

Έξοδος

<img src="images/myimage.jpg">

url_escape

Διαφυγή URI από μια συμβολοσειρά, για να συμπεριληφθεί σε μια διεύθυνση URL.

Κώδικας

{{ 'This & that//' | url_escape }}

Έξοδος

This+%26+that%2F%2F

xml_escape

Διαφυγή XML από μια συμβολοσειρά, για να συμπεριληφθεί σε μια έξοδο XML.

Κώδικας

{{ '<p>test</p>' | xml_escape }}

Έξοδος

&lt;p&gt;test&lt;/p&gt;

Φίλτρα λίστας

Τα φίλτρα λίστας χρησιμοποιούνται για να επεξεργαστείτε ορισμένες τιμές χαρακτηριστικών entitylist και για να σας βοηθήσουν να δημιουργήσετε προβολές λίσταςν.

current_sort

Με μια δεδομένη παράσταση, επιστρέφει την τρέχουσα κατεύθυνση ταξινόμησης για ένα συγκεκριμένο χαρακτηριστικό.

Κώδικας

{{ 'name ASC, createdon DESC' | current_sort: 'createdon' }}

Έξοδος

DESC

metafilters

Αναλύει μια τιμή JSON filter_definition entitylist σε αντικείμενα ομάδας επιλογής φίλτρου.

Το metafilters μπορεί να παρέχεται προαιρετικά με ένα τρέχον ερώτημα φίλτρου χαρακτηριστικού και το τρέχον entitylist, επιτρέποντας τα αντικείμενα φίλτρου που επιστρέφονται να σημανθούν ως επιλεγμένα ή μη επιλεγμένα.

Κώδικας

{% assign filters = entitylist | metafilters: params.mf, entityview %}
{% if filters.size > 0 %}
  <ul id=entitylist-filters>
    {% for filter in filters %}
      <li class=entitylist-filter-option-group>
        {% if filter.selection_mode == 'Single' %}
          {% assign type = 'radio' %}
        {% else %}
          {% assign type = 'checkbox' %}
        {% endif %}
        <h4 class=entitylist-filter-option-group-label
          data-filter-id={{ filter.id | h }}>
          {{ filter.label | h }}
        </h4>
        <ul>
          {% for option in filter.options %}
            <li class=entitylist-filter-option>
              {% if option.type == 'text' %}
                <div class=input-group entitylist-filter-option-text>
                  <span class=input-group-addon>
                    <span class=fa fa-filter aria-hidden=true></span>
                  </span>
                  <input class=form-control
                    type=text
                    name={{ filter.id | h }}
                    value={{ option.text | h }} />
                </div>
              {% else %}
                <div class={{ type | h }}>
                  <label>
                    <input
                      type={{ type | h }}
                      name={{ filter.id | h }}
                      value={{ option.id | h }}
                      {% if option.checked %}
                        checked=checked
                        data-checked=true{% endif %}
                      />
                    {{ option.label | h }}
                  </label>
                </div>
              {% endif %}
            </li>
          {% endfor %}
        </ul>
      </li>
    {% endfor %}
  </ul>
  <button class=btn btn-default data-serialized-query=mf data-target=#entitylist-filters>Apply Filters</button>
{% endif %}

reverse_sort

Με μια δεδομένη κατεύθυνση ταξινόμησης, επιστρέφει την αντίθετη κατεύθυνση ταξινόμησης.

Κώδικας

<!-- Sort direction is not case-sensitive -->

{{ 'ASC' | reverse_sort }}

{{ 'desc' | reverse_sort }}

Έξοδος

DESC

ASC

Μαθηματικά φίλτρα

Τα μαθηματικά φίλτρα σάς επιτρέπουν να εκτελείτε μαθηματικές πράξεις στο αριθμοί.

Όπως συμβαίνει με όλα τα φίλτρα, έτσι και τα μαθηματικά φίλτρα μπορούν να συνδεθούν και εφαρμόζονται με τη σειρά από τα αριστερά προς τα δεξιά.

Κώδικας

{{ 10 | times: 2 | minus: 5 | divided_by: 3 }}

Έξοδος

ceil

Στρογγυλοποιεί μια τιμή προς τα επάνω στον πλησιέστερο ακέραιο.

Κώδικας

{{ 4.6 | ceil }}

{{ 4.3 | ceil }}

Έξοδος

5

5

divided_by

Διαιρεί έναν αριθμό με έναν άλλο.

Κώδικας

{{ 10 | divided_by: 2 }}

{{ 10 | divided_by: 3 }}

{{ 10.0 | divided_by: 3 }}

Έξοδος

floor

Στρογγυλοποιεί μια τιμή προς τα κάτω στον πλησιέστερο ακέραιο.

Κώδικας

{{ 4.6 | floor }}

{{ 4.3 | floor }}

Έξοδος

4

4

minus

Αφαιρεί έναν αριθμό από έναν άλλο.

Κώδικας

<!-- entityview.page = 11 -->

{{ entityview.page | minus: 1 }}

{{ 10 | minus: 1.1 }}

{{ 10.1 | minus: 1 }}

Έξοδος

modulo

Διαιρεί έναν αριθμό με έναν άλλο και αποδίδει το υπόλοιπο.

Κώδικας

{{ 12 | modulo: 5 }}

Έξοδος

συν

Προσθέτει έναν αριθμό σε έναν άλλο.

Κώδικας

<!-- entityview.page = 11 -->

{{ entityview.page | plus: 1 }}

{{ 10 | plus: 1.1 }}

{{ 10.1 | plus: 1 }}

Έξοδος

round

Στρογγυλοποιεί μια τιμή στον πλησιέστερο ακέραιο ή στον καθορισμένο αριθμό δεκαδικών ψηφίων.

Κώδικας

{{ 4.6 | round }}

{{ 4.3 | round }}

{{ 4.5612 | round: 2 }}

Έξοδος

times

Πολλαπλασιάζει έναν αριθμό με έναν άλλο.

Κώδικας

{{ 10 | times: 2 }}

{{ 10 | times: 2.2 }}

{{ 10.1 | times: 2 }}

Έξοδος

Φίλτρα συμβολοσειρών

Τα φίλτρα συμβολοσειρών διαχειρίζονται συμβολοσειρές.

προσάρτηση

Προσθέτει μια συμβολοσειρά στο τέλος μιας άλλης συμβολοσειράς.

Κώδικας

{{ 'filename' | append: '.js' }}

Έξοδος

filename.js

μετατροπή σε κεφαλαία

μετατρέπει σε κεφαλαία κάθε λέξη μιας συμβολοσειράς.

Κώδικας

{{ 'capitalize me' | capitalize }}

Έξοδος

Capitalize Me

πεζά γράμματα

Μετατρέπει μια συμβολοσειρά σε πεζούς χαρακτήρες.

Κώδικας

{{ 'MIxed Case TExt' | downcase }}

Έξοδος

mixed case text

newline_to_br

Εισάγει μια ετικέτα <br /> αλλαγής γραμμής HTML σε κάθε αλλαγή γραμμής σε μια συμβολοσειρά.

Κώδικας

{% capture text %}

A

B

C

{% endcapture %}

{{ text | newline_to_br }}

Έξοδος

A<br />

B<br />

C<br />

προσάρτηση

Προσαρτά μια συμβολοσειρά στην αρχή μιας άλλης συμβολοσειράς.

Κώδικας

{{ 'Jane Johnson' | prepend: 'Dr. ' }}

Έξοδος

Dr. Jane Johnson

κατάργηση

Καταργήστε όλες τις εμφανίσεις μιας δευτερεύουσας συμβολοσειράς από μια συμβολοσειρά.

Κώδικας

{{ 'Hello, Dave. How are you, Dave?' | remove: 'Dave' }}

Έξοδος

Hello, . How are you, ?

remove_first

Καταργεί την πρώτη εμφάνιση μιας δευτερεύουσας συμβολοσειράς από μια συμβολοσειρά.

Κώδικας

{{ 'Hello, Dave. How are you, Dave?' | remove_first: 'Dave' }}

Έξοδος

Hello, . How are you, Dave?

αντικατάσταση

Αντικαθιστά όλες τις εμφανίσεις μιας συμβολοσειράς με μια δευτερεύουσα συμβολοσειρά.

Κώδικας

{{ 'Hello, Dave. How are you, Dave?' | replace: 'Dave', 'John' }}

Έξοδος

Hello, John. How are you, John?

replace_first

Αντικαθιστά την πρώτη εμφάνιση μιας συμβολοσειράς με μια δευτερεύουσα συμβολοσειρά.

Κώδικας

{{ 'Hello, Dave. How are you, Dave?' | replace_first: 'Dave', 'John' }}

Έξοδος

Hello, John. How are you, Dave?

διαχωρισμός

Το φίλτρο διαχωρισμού αποκτά μια δευτερεύουσα συμβολοσειρά ως παράμετρο. Η δευτερεύουσα συμβολοσειρά χρησιμοποιείται ως διαχωριστικό για να διαιρέσετε μια συμβολοσειρά σε έναν πίνακα.

Κώδικας

{% assign words = This is a demo of the split filter | split: ' ' %}

First word: {{ words.first }}

First word: {{ words[0] }}

Second word: {{ words[1] }}

Last word: {{ words.last }}

All words: {{ words | join: ', ' }}

Έξοδος

First word: This

First word: This

Second word: is

Last word: filter

All words: This, is, a, demo, of, the, split, filter

strip_html

Αφαιρεί όλες τις ετικέτες HTML από μια συμβολοσειρά.

Κώδικας

<p>Hello</p>

Έξοδος

Hello

strip_newlines

Αφαιρεί τυχόν αλλαγές γραμμών από μια συμβολοσειρά.

Κώδικας

{% capture text %}

A

B

C

{% endcapture %}

{{ text | strip_newlines }}

Έξοδος

ABC

text_to_html

Διαμορφώνει μια συμβολοσειρά απλού κειμένου ως απλή μορφή HTML. Το κείμενο είναι κωδικοποιημένο σε HTML, τα μπλοκ που διαχωρίζονται με μια κενή γραμμή θα περιλαμβάνονται στις ετικέτες της παραγράφου <p>, οι απλές αλλαγές γραμμών θα αντικαθίστανται με <br>, και οι διευθύνσεις URL μετατρέπονται σε υπερ-συνδέσεις.

Κώδικας

{{ note.notetext | text_to_html }}

Έξοδος

<p>This is the first paragraph of notetext. It contains a URL: <a href="https://example.com/" rel="nofollow">https://example.com</a></p>

<p>This is a second paragraph.</p>

περικοπή

Περικόπτει μια συμβολοσειρά σε έναν συγκεκριμένο αριθμό χαρακτήρων. Μια έλλειψη (...) θα προσαρτηθεί στη συμβολοσειρά και θα περιλαμβάνεται στην καταμέτρηση χαρακτήρων.

Κώδικας

{{ 'This is a long run of text.' | truncate: 10 }}

Έξοδος

This is...

truncate_words

Περικόπτει μια συμβολοσειρά σε έναν συγκεκριμένο αριθμό λέξεων. Μια έλλειψη (...) θα προσαρτηθεί στη συμβολοσειρά που έχει περικοπεί.

Κώδικας

{{ 'This is a long run of text.' | truncate_words: 3 }}

Έξοδος

This is a...

κεφαλαία

Μετατρέπει μια συμβολοσειρά σε κεφαλαία.

Κώδικας

{{ 'MIxed Case TExt' | upcase }}

Έξοδος

MIXED CASE TEXT

Φίλτρα τύπου

Τα φίλτρα τύπου σάς επιτρέπουν να μετατρέπετε τιμές από έναν τύπο σε άλλους τύπους.

boolean

Προσπαθεί να μετατρέψει μια τιμή συμβολοσειράς σε μια δυαδική τιμή. Εάν η τιμή είναι ήδη δυαδική, επιστρέφεται χωρίς αλλαγή. Εάν η τιμή δεν μπορεί να μετατραπεί σε μια δυαδική τιμή, το null θα επιστραφεί.

Αυτό το φίλτρο θα δέχεται επίσης τις επιλογές "ενεργό", "ενεργοποιημένο" ή "ναι" ως true και "ανενεργό", "απενεργοποιημένο" και "όχι" ως false.

Κώδικας

{{ true | boolean }}

{{ 'false' | boolean }}

{{ 'enabled' | boolean }}

{{ settings['something/enabled'] | boolean | default: false }}

Έξοδος

true

false

true

false

δεκαδικός

Προσπαθεί να μετατρέψει μια τιμή συμβολοσειράς σε δεκαδικό αριθμό. Εάν η τιμή είναι ήδη δεκαδική, επιστρέφεται χωρίς αλλαγή. Εάν η τιμή δεν μπορεί να μετατραπεί σε δεκαδικό αριθμό, το null θα επιστραφεί.

Κώδικας

{{ 10.1 | decimal }}

{{ '3.14' | decimal }}

{{ 'text' | decimal | default: 3.14 }}

Έξοδος

ακέραιος

Προσπαθεί να μετατρέψει μια τιμή συμβολοσειράς σε ακέραιο. Εάν η τιμή είναι ήδη ακέραιος αριθμός, επιστρέφεται χωρίς αλλαγή. Εάν η τιμή δεν μπορεί να μετατραπεί σε ακέραιο, το null θα επιστραφεί.

Κώδικας

{{ 10 | integer }}

{{ '10' | integer }}

{{ '10.1' | integer }}

{{ 'text' | integer | default: 2 }}

Έξοδος

συμβολοσειρά

Προσπαθεί να μετατρέψει μια τιμή στην αναπαράσταση συμβολοσειράς της. Εάν η τιμή είναι ήδη μια συμβολοσειρά, επιστρέφεται χωρίς αλλαγή. Εάν η τιμή είναι null, θα επιστραφεί null.

Φίλτρα URL

Τα φίλτρα URL σάς επιτρέπουν να δημιουργείτε και να εξαγάγετε τμήματα των διευθύνσεων URL.

add_query

Προσαρτά μια παράμετρο συμβολοσειράς ερωτήματος σε μια διεύθυνση URL. Εάν υπάρχει ήδη η παράμετρος στη διεύθυνση URL, ενημερώνεται η τιμή της παραμέτρου.

Εάν αυτό το φίλτρο εφαρμόζεται σε μια πλήρη απόλυτη διεύθυνση URL, μια ενημερωμένη, απόλυτη διεύθυνση URL είναι το αποτέλεσμα. Εάν εφαρμοστεί σε μια διαδρομή, μια ενημερωμένη διαδρομή είναι το αποτέλεσμα.

Κώδικας

{{ 'https://example.com/path?page=1' | add_query: 'foo', 'bar' }}

{{ '/path?page=1' | add_query: 'page', 2 }}

Έξοδος

https://example.com/path?page=1&foo=bar

/path?page=2

βάση

Λαμβάνει το URL βάσης μιας συγκεκριμένης διεύθυνσης URL.

Κώδικας

{{ 'https://example.com/path?foo=bar&page=2' | base }}

Έξοδος

https://example.com

κεντρικός υπολογιστής

Λαμβάνει το κεντρικό τμήμα μιας διεύθυνσης URL.

Κώδικας

{{ 'https://example.com/path?foo=bar&page=2' | host }}

Έξοδος

example.com

διαδρομή

Λαμβάνει το τμήμα διαδρομής μιας διεύθυνσης URL.

Κώδικας

{{ 'https://example.com/path?foo=bar&page=2' | path }}

{{ '/path?foo=bar&page=2' | path }}

Έξοδος

/path

/path

path_and_query

Λαμβάνει τη διαδρομή και το τμήμα ερωτήματος μιας διεύθυνσης URL.

Κώδικας

{{ 'https://example.com/path?foo=bar&page=2' | path_and_query }}

{{ '/path?foo=bar&page=2' | path_and_query }}

Έξοδος

/path?foo=bar&page=2

/path?foo=bar&page=2

θύρα

Λαμβάνει τον αριθμό θύρας μιας διεύθυνσης URL.

Κώδικας

{{ 'https://example.com/path?foo=bar&page=2' | port }}

{{ 'https://example.com/path?foo=bar&page=2' | port }}

{{ 'https://example.com:9000/path?foo=bar&page=2' | port }}

Έξοδος

remove_query

Καταργεί μια παράμετρο συμβολοσειράς ερωτήματος από μια διεύθυνση URL. Εάν η παράμετρος δεν υπάρχει στη διεύθυνση URL, η διεύθυνση URL επιστρέφεται ως έχει.

Κώδικας

{{ 'https://example.com/path?page=1' | remove_query: 'page' }}

{{ '/path?page=1' | remove_query: 'page' }}

Έξοδος

https://example.com/path

/path

σχήμα

Λαμβάνει το σχήμα μιας διεύθυνσης URL.

Κώδικας

{{ 'https://example.com/path?foo=bar&page=2' | scheme }}

{{ 'https://example.com/path?foo=bar&page=2' | scheme }}

Έξοδος

http

https

Πρόσθετα φίλτρα

Αυτά τα φίλτρα παρέχουν χρήσιμες γενικές λειτουργίες.

προεπιλογή

Επιστρέφει μια προεπιλεγμένη τιμή για οποιαδήποτε μεταβλητή χωρίς αντιστοιχισμένη τιμή (δηλαδή null).

Κώδικας

{{ snippets[Header] | default: 'My Website' }}

Έξοδος

<!-- If a snippet with the name Header returns null -->

My Website

file_size

Εφαρμόζεται σε μια αριθμητική τιμή που αντιπροσωπεύει πολλά byte, επιστρέφει ένα μέγεθος μορφοποιημένου αρχείου με μια μονάδα κατάλληλης κλίμακας.

Προαιρετικά, μπορεί να διαβιβαστεί μια παράμετρος ακρίβειας για να ελέγξετε τον αριθμό των δεκαδικών ψηφίων στο αποτέλεσμα. Η προεπιλεγμένη ακρίβεια είναι 1.

Κώδικας

{{ 10000000 | file_size }}

{{ 2050 | file_size: 0 }}

{{ entity.notes.first.filesize | file_size: 2 }}

Έξοδος

9.5 MB

2 KB

207.14 KB

ώ

Παρέχει μια αναπαράσταση HTML ενός χαρακτηριστικού. Για παράδειγμα, που δείχνει μια αναπαράσταση HTML του χαρακτηριστικού XML του ερωτήματος FetchXML.

Κώδικας

{{ samplequery.xml | h }}

Έξοδος

<fetch mapping="logical" count="5000" page="1" returntotalrecordcount="true"> <entity name="contact"> <attribute name="fullname" /> </entity> </fetch>

has_role

Εάν εφαρμοστεί σε έναν χρήστη, επιστρέφει true εάν ο χρήστης ανήκει στον συγκεκριμένο ρόλο. Επιστρέφει false εάν δεν είναι.

Κώδικας

{% assign is_admin = user | has_role: 'Administrators' %}

{% if is_admin %}

User is an administrator.

{% endif %}

liquid

Αποδίδει μια συμβολοσειρά ως κώδικα Liquid. Αυτός ο κώδικας έχει πρόσβαση στο τρέχον περιβάλλον εκτέλεσης Liquid (μεταβλητές, κ.λπ.).

Σημείωμα

Αυτό το φίλτρο πρέπει να χρησιμοποιείται με προσοχή και γενικά θα πρέπει να εφαρμόζεται μόνο σε τιμές που βρίσκονται υπό τον αποκλειστικό έλεγχο των συντακτών περιεχομένου της τοποθεσίας ή άλλων χρηστών που μπορούν να θεωρηθούν αξιόπιστοι για την εγγραφή κώδικα Liquid.

Κώδικας

{{ page.adx_copy | liquid }}

Κοινή χρήση μέσω

Διαθέσιμα φίλτρα Liquid

Φίλτρα πίνακα

δέσμη

concat

εκτός από

Πρώτη

group_by

join

Τελευταία

order_by

random

select

shuffle

size

skip

take

then_by

όπου

Φίλτρα ημερομηνίας

ημερομηνία

date_add_days

date_add_hours

date_add_minutes

date_add_months

date_add_seconds

date_add_years

date_to_iso8601

date_to_rfc822

Φίλτρα διαφυγής

escape

html_safe_escape

url_escape

xml_escape

Φίλτρα λίστας

current_sort

metafilters

reverse_sort

Μαθηματικά φίλτρα

ceil

divided_by

floor

minus

modulo

συν

round

times

Φίλτρα συμβολοσειρών

προσάρτηση

μετατροπή σε κεφαλαία

πεζά γράμματα

newline_to_br

προσάρτηση

κατάργηση

remove_first

αντικατάσταση

replace_first

διαχωρισμός

strip_html

strip_newlines

text_to_html

περικοπή

truncate_words

κεφαλαία

Φίλτρα τύπου

boolean

δεκαδικός

ακέραιος

συμβολοσειρά

Φίλτρα URL

add_query

βάση

κεντρικός υπολογιστής

διαδρομή

path_and_query

θύρα

remove_query

σχήμα

Πρόσθετα φίλτρα

προεπιλογή