Bộ lọc Liquid có sẵn

2025-01-30

Bộ lọc Liquid được sử dụng để sửa đổi đầu ra của chuỗi, số, biến và đối tượng. Chúng được tách khỏi giá trị mà chúng được áp dụng bằng |.

{{ 'hal 9000' | upcase }} 

Một số bộ lọc chấp nhận các tham số. Bộ lọc cũng có thể được kết hợp và được áp dụng theo thứ tự từ trái sang phải.

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

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

Phần bên dưới mô tả nhiều bộ lọc.

Bộ lọc mảng

Bộ lọc mảng được sử dụng để hoạt động cùng mảng.

hàng loạt

Chia một mảng thành nhiều mảng có kích thước nhất định.

Mã số

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

{% for batch in batches %}

<ul>

{% for item in batch %}

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

{% endfor %}

</ul>

{% endfor %}

Đầu ra

<ul>

<li>John Smith</li>

<li>Dave Thomas</li>

</ul>

<ul>

<li>Jake Johnson</li>

<li>Jack Robinson</li>

</ul>

ghép

Ghép hai mảng thành một mảng mới.

Cho mục là tham số, concat trả về mảng mới bao gồm mảng ban đầu, với mục đã cho dưới dạng phần tử cuối cùng.

Mã số

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

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

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

Đầu ra

Group #1: John, Pete, Hannah

Group #2: Joan, Bill

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

ngoại trừ

Chọn tất cả các đối tượng trong mảng mà thuộc tính đã cho không có giá trị nhất định. (Đây là nghịch đảo của vị trí.)

Mã số

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

{% for item in redmond %}

{{ item.fullname }}

{% endfor %}

Đầu ra

Jack Robinson

đầu tiên

Trả về phần tử đầu tiên của mảng.

first cũng có thể được sử dụng với ký hiệu dấu chấm đặc biệt, trong những trường hợp cần sử dụng trong thẻ.

Mã số

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

{{ words | first }}

{% if words.first == This %}

The first word is This.

{% endif %}

Đầu ra

This

The first word is This.

group_by

Nhóm các mục trong mảng theo thuộc tính nhất định.

Mã số

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

{% for group in groups %}

{{ group.key }}:

{% for item in group.items %}

{{ item.fullname }}

{% endfor %}

{% endfor %}

Đầu ra

Redmond:

John Smith

Dave Thomas

Jake Johnson

New York:

Jack Robinson

tham gia

Kết hợp các phần tử của mảng với ký tự đã thông qua dưới dạng tham số. Kết quả là chuỗi duy nhất.

Mã số

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

{{ words | join: ,  }}

Đầu ra

This, is, a, run, of, text

cuối cùng

Trả về phần tử cuối cùng của mảng.

last cũng có thể được sử dụng với ký hiệu dấu chấm đặc biệt, trong những trường hợp cần sử dụng trong thẻ.

Mã số

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

{{ words | last }}

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

The last word is text.

{% endif -%}

Đầu ra

text

The last word is text.

order_by

Trả về các phần tử của mảng được sắp xếp theo thuộc tính nhất định của các phần tử mảng.

Ngoài ra, bạn có thể cung cấp desc dưới dạng tham số thứ hai để sắp xếp phần tử theo thứ tự giảm dần, chứ không phải tăng dần.

Mã số

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

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

Đầu ra

Dave Thomas, Jack Robinson, Jake Johnson, John Smith

John Smith, Jake Johnson, Jack Robinson, Dave Thomas

ngẫu nhiên

Trả về một mục được chọn ngẫu nhiên từ mảng.

Mã số

{{ group1 | join: ', ' }}

{{ group1 | random }}

Đầu ra

John, Pete, Hannah

Pete

chọn

Chọn giá trị của thuộc tính nhất định cho từng mục trong mảng và trả về các giá trị này dưới dạng mảng.

Mã số

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

Đầu ra

Redmond, New York

phát ngẫu nhiên

Được áp dụng cho mảng, trả về mảng mới có cùng số mục, theo thứ tự ngẫu nhiên.

Mã số

{{ group1 | join: ', ' }}

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

Đầu ra

John, Pete, Hannah

Hannah, John, Pete

kích thước

Trả về số lượng mục trong mảng.

size cũng có thể được sử dụng với ký hiệu dấu chấm đặc biệt, trong những trường hợp cần sử dụng trong thẻ.

Mã số

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

{{ words | size }}

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

The text contains 6 words.

{% endif -%}

Đầu ra

6

The text contains 6 words.

bỏ qua

Bỏ qua một số mục nhất định trong mảng và trả về phần còn lại.

Mã số

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

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

Đầu ra

run, of, text

lấy

Lấy một số mục nhất định từ mảng, trả về các mục đã lấy.

Mã số

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

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

Đầu ra


This, is, a

then_by

Thêm thứ tự tiếp theo bổ sung vào mảng đã được sắp xếp theo order_by.

Ngoài ra, bạn có thể cung cấp desc dưới dạng tham số thứ hai để sắp xếp phần tử theo thứ tự giảm dần, chứ không phải tăng dần.

Mã số

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

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

Đầu ra

Dave Thomas, Jack Robinson, Jake Johnson, John Smith

John Smith, Jake Johnson, Jack Robinson, Dave Thomas

địa điểm

Chọn tất cả các đối tượng trong mảng mà thuộc tính đã cho có giá trị nhất định.

Mã số

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

{% for item in redmond %}

{{ item.fullname }}

{% endfor %}

Đầu ra

John Smith

Dave Thomas

Jake Johnson

Bộ lọc ngày

Có thể sử dụng bộ lọc ngày cho số học ngày hoặc để chuyển đổi giá trị DateTime thành định dạng khác.

ngày

Định dạng giá trị DateTime bằng cách sử dụng chuỗi định dạng .NET.

Chuỗi định dạng ngày và giờ chuẩn

Chuỗi định dạng ngày và giờ tùy chỉnh

Mã số

{{ now | date: 'g' }}

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

Đầu ra

5/7/2018 7:20 AM

May 07, 2018

date_add_days

Thêm số ngày nguyên và thập phân được chỉ định vào giá trị DateTime. Tham số có thể là dương hoặc âm.

Mã số

{{ now }}

{{ now | date_add_days: 1 }}

{{ now | date_add_days: -2.5 }}

Đầu ra

5/7/2018 7:20:46 AM

5/8/2018 7:20:46 AM

5/4/2018 7:20:46 PM

date_add_hours

Thêm số giờ nguyên và thập phân được chỉ định vào giá trị DateTime. Tham số có thể là dương hoặc âm.

Mã số

{{ now }}

{{ now | date_add_hours: 1 }}

{{ now | date_add_hours: -2.5 }}

Đầu ra

5/7/2018 7:20:46 AM

5/7/2018 8:20:46 AM

5/7/2018 4:50:46 AM

date_add_minutes

Thêm số phút nguyên và thập phân được chỉ định vào giá trị DateTime. Tham số có thể là dương hoặc âm.

Mã số

{{ now }}

{{ now | date_add_minutes: 10 }}

{{ now | date_add_minutes: -2.5 }}

Đầu ra

5/7/2018 7:20:46 AM

5/7/2018 7:30:46 AM

5/7/2018 7:18:16 AM

date_add_months

Thêm số tháng nguyên và thập phân được chỉ định vào giá trị DateTime. Tham số có thể là dương hoặc âm.

Mã số

{{ now }}

{{ now | date_add_months: 1 }}

{{ now | date_add_months: -2 }}

Đầu ra

5/7/2018 7:20:46 AM

6/7/2018 7:20:46 AM

3/7/2018 7:20:46 AM

date_add_seconds

Thêm số giây nguyên và thập phân được chỉ định vào giá trị DateTime. Tham số có thể là dương hoặc âm.

Mã số

{{ now }}

{{ now | date_add_seconds: 10 }}

{{ now | date_add_seconds: -1.25 }}

Đầu ra

5/7/2018 7:20:46 AM

5/7/2018 7:20:56 AM

5/7/2018 7:20:45 AM

date_add_years

Thêm số năm nguyên được chỉ định vào giá trị DateTime. Tham số có thể là dương hoặc âm.

Mã số

{{ now }}

{{ now | date_add_years: 1 }}

{{ now | date_add_years: -2 }}

Đầu ra

5/7/2018 7:20:46 AM

5/7/2019 7:20:46 AM

5/7/2016 7:20:46 AM

date_to_iso8601

Định dạng giá trị Ngày Giờ tuân theo tiêu chuẩn ISO 8601. Hữu ích khi tạo nguồn cấp dữ liệu Atom hoặc phần tử <time> của HTML5.

Mã số

{{ now | date_to_iso8601 }}

Đầu ra

2018-05-07T07:20:46Z

date_to_rfc822

Định dạng giá trị DateTime theo Tiêu chuẩn RFC 822 tiêu chuẩn. Hữu ích khi tạo nguồn cấp dữ liệu RSS.

Mã số

{{ now | date_to_rfc822 }}

Đầu ra

Mon, 07 May 2018 07:20:46 Z

Bộ lọc ký tự thoát

Chuỗi thoát cung cấp một cách để bao gồm các ký tự đặc biệt trong chuỗi mà không xung đột với cách diễn giải thông thường các ký tự đó theo ngôn ngữ lập trình hoặc định dạng.

Các bộ lọc ký tự thoát sau đây thay thế các ký tự chuỗi bằng chuỗi thoát hoặc xóa các ký tự chuỗi không hợp lệ dựa trên loại đích.

bỏ trốn

Thoát HTML cho một chuỗi.

Mã số

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

Đầu ra

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

html_safe_escape

Chuyển đổi một chuỗi HTML nhất định thành một đoạn HTML an toàn.

Mã số

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

Đầu ra

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

thoát khỏi url

Thoát URI khỏi một chuỗi, để đưa vào một URL.

Mã số

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

Đầu ra

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

thoát khỏi xml

Thoát XML khỏi một chuỗi, để đưa vào một đầu ra XML.

Mã số

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

Đầu ra

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

Bộ lọc danh sách

Bộ lọc danh sách được sử dụng với một số giá trị thuộc tính entitylist nhất định và giúp tạo dạng xem danh sách.

current_sort

Cho một biểu thức sắp xếp, hãy trả về hướng sắp xếp hiện tại cho một thuộc tính nhất định.

Mã số

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

Đầu ra

DESC

metafilters

Phân tích giá trị JSON entitylist filter_definition thành các đối tượng nhóm tùy chọn bộ lọc.

Có thể lựa chọn cung cấp metafilters có truy vấn bộ lọc thuộc tính và entitylist hiện tại, cho phép các đối tượng bộ lọc được trả về được gắn cờ là đã chọn hoặc bỏ chọn.

Mã số

{% 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

Cho hướng sắp xếp, hãy trả về hướng sắp xếp ngược lại.

Mã số

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

{{ 'ASC' | reverse_sort }}

{{ 'desc' | reverse_sort }}

Đầu ra

DESC

ASC

Bộ lọc toán

Bộ lọc toán cho phép bạn thực hiện các phép tính toán học trên số.

Giống như mọi bộ lọc, bạn có thể tạo chuỗi cho bộ lọc toán học và áp dụng theo thứ tự từ trái sang phải.

Mã số

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

Đầu ra

làm tròn lên

Làm tròn giá trị đến số nguyên gần nhất.

Mã số

{{ 4.6 | ceil }}

{{ 4.3 | ceil }}

Đầu ra

5

5

divided_by

Chia một số cho một số khác.

Mã số

{{ 10 | divided_by: 2 }}

{{ 10 | divided_by: 3 }}

{{ 10.0 | divided_by: 3 }}

Đầu ra

làm tròn xuống

Làm tròn giá trị xuống số nguyên gần nhất.

Mã số

{{ 4.6 | floor }}

{{ 4.3 | floor }}

Đầu ra

4

4

trừ

Trừ một số từ một số khác.

Mã số

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

{{ entityview.page | minus: 1 }}

{{ 10 | minus: 1.1 }}

{{ 10.1 | minus: 1 }}

Đầu ra

mô-đun

Chia một số cho một số khác và trả về số dư.

Mã số

{{ 12 | modulo: 5 }}

Đầu ra

cộng

Cộng một số vào một số khác.

Mã số

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

{{ entityview.page | plus: 1 }}

{{ 10 | plus: 1.1 }}

{{ 10.1 | plus: 1 }}

Đầu ra

làm tròn

Làm tròn giá trị lên số nguyên gần nhất hoặc số thập phân được chỉ định.

Mã số

{{ 4.6 | round }}

{{ 4.3 | round }}

{{ 4.5612 | round: 2 }}

Đầu ra

nhân

Nhân một số với một số khác.

Mã số

{{ 10 | times: 2 }}

{{ 10 | times: 2.2 }}

{{ 10.1 | times: 2 }}

Đầu ra

Bộ lọc chuỗi

Bộ lọc chuỗi điều khiển chuỗi.

thêm

Gắn thêm một chuỗi vào cuối một chuỗi khác.

Mã số

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

Đầu ra

filename.js

viết hoa

Viết hoa tất cả các từ trong chuỗi.

Mã số

{{ 'capitalize me' | capitalize }}

Đầu ra

Capitalize Me

viết thường

Chuyển đổi một chuỗi thành chữ thường.

Mã số

{{ 'MIxed Case TExt' | downcase }}

Đầu ra

mixed case text

xuống dòng_tới_br

Chèn thẻ HTML ngắt dòng <br /> vào mỗi ngắt dòng trong một chuỗi.

Mã số

{% capture text %}

A

B

C

{% endcapture %}

{{ text | newline_to_br }}

Đầu ra

A<br />

B<br />

C<br />

thêm vào trước

Thêm một chuỗi vào đầu một chuỗi khác.

Mã số

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

Đầu ra

Dr. Jane Johnson

di dời

Xóa tất cả lần xuất hiện chuỗi phụ khỏi chuỗi.

Mã số

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

Đầu ra

Hello, . How are you, ?

xóa_đầu_tiên

Xóa lần xuất hiện chuỗi phụ đầu tiên khỏi chuỗi.

Mã số

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

Đầu ra

Hello, . How are you, Dave?

thay thế

Thay thế tất cả lần xuất hiện chuỗi bằng chuỗi phụ.

Mã số

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

Đầu ra

Hello, John. How are you, John?

thay thế_đầu tiên

Thay thế lần xuất hiện chuỗi đầu tiên bằng chuỗi phụ.

Mã số

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

Đầu ra

Hello, John. How are you, Dave?

tách ra

Bộ lọc split tiếp nhận chuỗi phụ dưới dạng một tham số. Chuỗi phụ được sử dụng như một dấu phân tách để chia chuỗi thành mảng.

Mã số

{% 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: ', ' }}

Đầu ra

First word: This

First word: This

Second word: is

Last word: filter

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

dải_html

Tách tất cả các thẻ HTML khỏi chuỗi.

Mã số

<p>Hello</p>

Đầu ra

Hello

dải_dòng mới

Tách mọi ngắt dòng khỏi một chuỗi.

Mã số

{% capture text %}

A

B

C

{% endcapture %}

{{ text | strip_newlines }}

Đầu ra

ABC

văn bản_thành_html

Định dạng một chuỗi văn bản thuần dưới dạng HTML đơn giản. Văn bản sẽ được mã hóa HTML, khối văn bản được phân tách bởi một dòng trống sẽ được gói trong các thẻ <p> của đoạn, ngắt dòng duy nhất sẽ được thay thế bằng <br> và URL sẽ được chuyển đổi thành siêu liên kết.

Mã số

{{ note.notetext | text_to_html }}

Đầu ra

<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>

cắt ngắn

Cắt bớt một chuỗi về số ký tự cho trước. Dấu ngoặc đơn (...) được gắn vào chuỗi và được bao gồm trong số ký tự.

Mã số

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

Đầu ra

This is...

cắt bớt từ

Cắt bớt một chuỗi về số từ cho trước. Dấu ngoặc đơn (...) được gắn vào chuỗi bị cắt bớt.

Mã số

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

Đầu ra

This is a...

viết hoa

Chuyển đổi chuỗi thành chữ hoa.

Mã số

{{ 'MIxed Case TExt' | upcase }}

Đầu ra

MIXED CASE TEXT

Bộ lọc loại

Bộ lọc loại cho phép bạn chuyển đổi giá trị của một loại thành các loại khác.

Boolean

Cố gắng chuyển đổi giá trị chuỗi thành Boolean. Nếu đã là Boolean, giá trị này sẽ được trả về là không thay đổi. Nếu bạn không thể chuyển đổi giá trị thành Boolean, null sẽ bị trả về.

Ngoài ra, bộ lọc này cũng sẽ chấp nhận "on", "enabled" hoặc "yes" là true, còn "off", "disabled" và "no" là false.

Mã số

{{ true | boolean }}

{{ 'false' | boolean }}

{{ 'enabled' | boolean }}

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

Đầu ra

true

false

true

false

số thập phân

Cố gắng chuyển đổi giá trị chuỗi thành số thập phân. Nếu đã là số thập phân, giá trị này sẽ được trả về là không thay đổi. Nếu bạn không thể chuyển đổi giá trị thành số thập phân, null sẽ được trả về.

Mã số

{{ 10.1 | decimal }}

{{ '3.14' | decimal }}

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

Đầu ra

số nguyên

Cố gắng chuyển đổi giá trị chuỗi thành số nguyên. Nếu đã là số nguyên, giá trị này sẽ được trả về là không thay đổi. Nếu bạn không thể chuyển đổi giá trị thành số nguyên, null sẽ được trả về.

Mã số

{{ 10 | integer }}

{{ '10' | integer }}

{{ '10.1' | integer }}

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

Đầu ra

sợi dây

Cố gắng chuyển đổi giá trị thành đại diện chuỗi. Nếu đã là chuỗi, giá trị này sẽ được trả về là không thay đổi. Nếu giá trị là null, null sẽ bị trả về.

Bộ lọc URL

Bộ lọc URL cho phép bạn xây dựng hoặc trích xuất các phần của URL.

thêm_truy_cập

Gắn tham số chuỗi truy vấn vào URL. Nếu tham số đã tồn tại trong URL, giá trị của tham số này sẽ được cập nhật.

Nếu bộ lọc này được áp dụng cho một URL tuyệt đối đầy đủ, kết quả sẽ là URL tuyệt đối được cập nhật. Nếu bộ lọc này được áp dụng cho một đường dẫn, kết quả sẽ là đường dẫn được cập nhật.

Mã số

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

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

Đầu ra

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

/path?page=2

căn cứ

Lấy URL cơ sở của một URL cho trước.

Mã số

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

Đầu ra

https://example.com

chủ nhà

Lấy phần lưu trữ của URL.

Mã số

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

Đầu ra

example.com

con đường

Lấy phần đường dẫn của URL.

Mã số

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

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

Đầu ra

/path

/path

đường dẫn và truy vấn

Lấy phần đường dẫn và truy vấn của URL.

Mã số

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

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

Đầu ra

/path?foo=bar&page=2

/path?foo=bar&page=2

cảng

Lấy số cổng của URL.

Mã số

{{ '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 }}

Đầu ra

xóa_truy_cập

Xóa tham số chuỗi truy vấn khỏi URL. Nếu tham số không tồn tại trong URL, URL sẽ được trả lại không thay đổi.

Mã số

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

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

Đầu ra

https://example.com/path

/path

cơ chế

Lấy phần giao thức của URL.

Mã số

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

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

Đầu ra

http

https

Bộ lọc bổ sung

Các bộ lọc này cung cấp chức năng tổng hợp hữu ích.

mặc định

Trả về giá trị mặc định cho bất kỳ biến nào không có giá trị được gán (tức là null).

Mã số

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

Đầu ra

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

My Website

kích thước tập tin

Áp dụng cho một giá trị số đại diện cho nhiều byte, trả về một kích thước tệp được định dạng với một đơn vị tỷ lệ thích hợp.

Ngoài ra, có thể truyền một tham số chính xác để kiểm soát số lượng các chữ số thập phân trong kết quả. Tham số chính xác mặc định là 1.

Mã số

{{ 10000000 | file_size }}

{{ 2050 | file_size: 0 }}

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

Đầu ra

9.5 MB

2 KB

207.14 KB

giờ

Cung cấp một biểu diễn HTML của một thuộc tính. Ví dụ, hiển thị biểu diễn HTML của FetchXML truy vấn của Thuộc tính XML.

Mã số

{{ samplequery.xml | h }}

Đầu ra

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

có vai trò

Áp dụng cho một người dùng, trả về true nếu người dùng thuộc về một vai trò cho trước. Nếu không, trả về false.

Mã số

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

{% if is_admin %}

User is an administrator.

{% endif %}

chất lỏng

Kết xuất một chuỗi dưới dạng mã Liquid. Mã này sẽ có quyền truy cập vào bối cảnh thực thi Liquid hiện tại (biến, v.v.).

Lưu ý

Cần sử dụng bộ lọc này với sự thận trọng và nói chung chỉ nên áp dụng cho các giá trị dưới sự kiểm soát độc quyền của tác giả nội dung trên site hoặc những người dùng khác có thể tin cậy để viết mã Liquid.

Mã số

{{ page.adx_copy | liquid }}

Chia sẻ qua

Bộ lọc Liquid có sẵn

Bộ lọc mảng

hàng loạt

ghép

ngoại trừ

đầu tiên

group_by

tham gia

cuối cùng

order_by

ngẫu nhiên

chọn

phát ngẫu nhiên

kích thước

bỏ qua

lấy

then_by

địa điểm

Bộ lọc ngày

ngày

date_add_days

date_add_hours

date_add_minutes

date_add_months

date_add_seconds

date_add_years

date_to_iso8601

date_to_rfc822

Bộ lọc ký tự thoát

bỏ trốn

html_safe_escape

thoát khỏi url

thoát khỏi xml

Bộ lọc danh sách

current_sort

metafilters

reverse_sort

Bộ lọc toán

làm tròn lên

divided_by

làm tròn xuống

trừ

mô-đun

cộng

làm tròn

nhân

Bộ lọc chuỗi

thêm

viết hoa

viết thường

xuống dòng_tới_br

thêm vào trước

di dời

xóa_đầu_tiên

thay thế

thay thế_đầu tiên

tách ra

dải_html

dải_dòng mới

văn bản_thành_html

cắt ngắn

cắt bớt từ

viết hoa

Bộ lọc loại

Boolean

số thập phân

số nguyên

sợi dây

Bộ lọc URL

thêm_truy_cập

căn cứ

chủ nhà

con đường

đường dẫn và truy vấn

cảng

xóa_truy_cập

cơ chế

Bộ lọc bổ sung

mặc định