Bộ lọc Liquid có sẵn
Lưu ý
Từ ngày 12 tháng 10 năm 2022, cổng thông tin Power Apps sẽ trở thành Power Pages. Thông tin khác: Microsoft Power Pages hiện đã được phát hành rộng rãi (blog)
Chúng tôi sẽ sớm di chuyển và hợp nhất hướng dẫn sử dụng cổng thông tin Power Apps với hướng dẫn sử dụng Power Pages.
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 }} <!-- Output: HAL 9000 -->
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ã
{% 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ã
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ủavị trí.)
Mã
{% 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ã
{% 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ã
{% 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ã
{% 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ã
{% 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ã
{{ 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ã
{{ 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ã
{{ 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ã
{{ 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ã
{% 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ã
{% 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ã
{% 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 theoorder_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ã
{{ 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ã
{% 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ờ Tiêu chuẩn
Chuỗi Định dạng Ngày và Giờ Tùy chỉnh
Mã
{{ 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ã
{{ 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ã
{{ 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ã
{{ 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ã
{{ 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ã
{{ 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ã
{{ 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ã
{{ now | date_to_iso8601 }}
Đầu ra
2018-05-07T07:20:46Z
date_to_rfc822
Định dạng giá trị Ngày Giờ tuân theo tiêu chuẩn RFC 822. Hữu ích khi tạo nguồn cấp dữ liệu RSS.
Mã
{{ now | date_to_rfc822 }}
Kết quả
Mon, 07 May 2018 07:20:46 Z
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ã
{{ 'name ASC, createdon DESC' | current_sort: 'createdon' }}
Đầu ra
DESC
metafilters
Phân tích giá trị JSON filter_definition của entitylist thành đố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ã
{% 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ã
<!-- 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ã
{{ 10 | times: 2 | minus: 5 | divided_by: 3 }}
Đầu ra
5
làm tròn lên
Làm tròn giá trị đến số nguyên gần nhất.
Mã
{{ 4.6 | ceil }}
{{ 4.3 | ceil }}
Đầu ra
5
5
divided_by
Chia một số cho một số khác.
Mã
{{ 10 | divided_by: 2 }}
{{ 10 | divided_by: 3 }}
{{ 10.0 | divided_by: 3 }}
Đầu ra
5
3
3.333333
làm tròn xuống
Làm tròn giá trị xuống số nguyên gần nhất.
Mã
{{ 4.6 | floor }}
{{ 4.3 | floor }}
Đầu ra
4
4
trừ
Trừ một số từ một số khác.
Mã
<!-- entityview.page = 11 -->
{{ entityview.page | minus: 1 }}
{{ 10 | minus: 1.1 }}
{{ 10.1 | minus: 1 }}
Đầu ra
10
9
9.1
mô-đun
Chia một số cho một số khác và trả về số dư.
Mã
{{ 12 | modulo: 5 }}
Đầu ra
2
cộng
Cộng một số vào một số khác.
Mã
<!-- entityview.page = 11 -->
{{ entityview.page | plus: 1 }}
{{ 10 | plus: 1.1 }}
{{ 10.1 | plus: 1 }}
Đầu ra
12
11
11.1
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ã
{{ 4.6 | round }}
{{ 4.3 | round }}
{{ 4.5612 | round: 2 }}
Đầu ra
5
4
4.56
nhân
Nhân một số với một số khác.
Mã
{{ 10 | times: 2 }}
{{ 10 | times: 2.2 }}
{{ 10.1 | times: 2 }}
Đầu ra
20
20
20.2
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ã
{{ 'filename' | append: '.js' }}
Đầu ra
filename.js
capitalize
viết hoa chữ đầu tiên trong một chuỗi.
Mã
{{ 'capitalize me' | capitalize }}
Đầu ra
Capitalize Me
downcase
Chuyển đổi một chuỗi thành chữ thường.
Mã
{{ 'MIxed Case TExt' | downcase }}
Đầu ra
mixed case text
escape
Thoát HTML cho một chuỗi.
Mã
{{ '<p>test</p>' | escape }}
Đầu ra
<p>test</p>
newline_to_br
Chèn thẻ HTML ngắt dòng <br /> vào mỗi ngắt dòng trong một chuỗi.
Mã
{% capture text %}
A
B
C
{% endcapture %}
{{ text | newline_to_br }}
Đầu ra
A<br />
B<br />
C<br />
prepend
Thêm một chuỗi vào đầu một chuỗi khác.
Mã
{{ 'Jane Johnson' | prepend: 'Dr. ' }}
Đầu ra
Dr. Jane Johnson
remove
Xóa tất cả lần xuất hiện chuỗi phụ khỏi chuỗi.
Mã
{{ 'Hello, Dave. How are you, Dave?' | remove: 'Dave' }}
Đầu ra
Hello, . How are you, ?
remove_first
Xóa lần xuất hiện chuỗi phụ đầu tiên khỏi chuỗi.
Mã
{{ 'Hello, Dave. How are you, Dave?' | remove_first: 'Dave' }}
Đầu ra
Hello, . How are you, Dave?
replace
Thay thế tất cả lần xuất hiện chuỗi bằng chuỗi phụ.
Mã
{{ 'Hello, Dave. How are you, Dave?' | replace: 'Dave', 'John' }}
Đầu ra
Hello, John. How are you, John?
replace_first
Thay thế lần xuất hiện chuỗi đầu tiên bằng chuỗi phụ.
Mã
{{ 'Hello, Dave. How are you, Dave?' | replace_first: 'Dave', 'John' }}
Đầu ra
Hello, John. How are you, Dave?
split
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ã
{% 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
strip_html
Tách tất cả các thẻ HTML khỏi chuỗi.
Mã
<p>Hello</p>
Đầu ra
Hello
strip_newlines
Tách mọi ngắt dòng khỏi một chuỗi.
Mã
{% capture text %}
A
B
C
{% endcapture %}
{{ text | strip_newlines }}
Đầu ra
ABC
text_to_html
Định dạng một chuỗi văn bản thuần dưới dạng HTML đơn giản. Tất cả 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ã
{{ 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>
truncate
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ã
{{ 'This is a long run of text.' | truncate: 10 }}
Đầu ra
This is...
truncate_words
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ã
{{ 'This is a long run of text.' | truncate_words: 3 }}
Đầu ra
This is a...
upcase
Chuyển đổi chuỗi thành chữ hoa.
Mã
{{ 'MIxed Case TExt' | upcase }}
Đầu ra
MIXED CASE TEXT
url_escape
Thoát URI khỏi một chuỗi, để đưa vào một URL.
Mã
{{ 'This & that//' | url_escape }}
Đầu ra
This+%26+that%2F%2F
xml_escape
Thoát XML khỏi một chuỗi, để đưa vào một đầu ra XML.
Mã
{{ '<p>test</p>' | xml_escape }}
Đầu ra
<p>test</p>
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ã
{{ true | boolean }}
{{ 'false' | boolean }}
{{ 'enabled' | boolean }}
{{ settings['something/enabled'] | boolean | default: false }}
Đầu ra
true
false
true
false
decimal
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ã
{{ 10.1 | decimal }}
{{ '3.14' | decimal }}
{{ 'text' | decimal | default: 3.14 }}
Đầu ra
10.1
3.14
3.14
integer
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ã
{{ 10 | integer }}
{{ '10' | integer }}
{{ '10.1' | integer }}
{{ 'text' | integer | default: 2 }}
Đầu ra
10
10
2
string
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.
add_query
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ã
{{ '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
base
Lấy URL cơ sở của một URL cho trước.
Mã
{{ 'https://example.com/path?foo=bar&page=2' | base }}
Đầu ra
https://example.com
host
Lấy phần lưu trữ của URL.
Mã
{{ 'https://example.com/path?foo=bar&page=2' | host }}
Đầu ra
example.com
path
Lấy phần đường dẫn của URL.
Mã
{{ 'https://example.com/path?foo=bar&page=2' | path }}
{{ '/path?foo=bar&page=2' | path }}
Đầu ra
/path
/path
path_and_query
Lấy phần đường dẫn và truy vấn của URL.
Mã
{{ '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
port
Lấy số cổng của URL.
Mã
{{ '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
80
443
9000
remove_query
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.
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ã
{{ 'https://example.com/path?page=1' | remove_query: 'page' }}
{{ '/path?page=1' | remove_query: 'page' }}
Đầu ra
https://example.com/path
/path
scheme
Lấy phần giao thức của URL.
Mã
{{ '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.
default
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ã
{{ snippets[Header] | default: 'My Website' }}
Đầu ra
<!-- If a snippet with the name Header returns null -->
My Website
file_size
Áp dụng cho một giá trị số đại diện cho một số lượng 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ã
{{ 10000000 | file_size }}
{{ 2050 | file_size: 0 }}
{{ entity.notes.first.filesize | file_size: 2 }}
Đầu ra
9.5 MB
2 KB
207.14 KB
has_role
Á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ã
{% assign is_admin = user | has_role: 'Administrators' %}
{% if is_admin %}
User is an administrator.
{% endif %}
liquid
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 cổng thông tin hoặc những người dùng khác có thể tin cậy để viết mã Liquid.
Mã
{{ page.adx_copy | liquid }}
Xem thêm
Lưu trữ nội dung nguồn bằng các mẫu web
Tìm hiểu toán tử Liquid
Các loại Liquid
Đối tượng Liquid
Thẻ Liquid
Bộ lọc Liquid
Lưu ý
Bạn có thể cho chúng tôi biết bạn thích dùng ngôn ngữ nào cho tài liệu không? Làm một cuộc khảo sát ngắn. (xin lưu ý, khảo sát này bằng tiếng Anh)
Cuộc khảo sát sẽ mất khoảng bảy phút. Không có dữ liệu cá nhân nào được thu thập (điều khoản về quyền riêng tư).