ตัวกรอง Liquid ที่พร้อมใช้งาน

บทความ
03/16/2023

หมายเหตุ

พอร์ทัล Power Apps คือ Power Pages โดยมีผลในวันที่ 12 ตุลาคม 2022 ข้อมูลเพิ่มเติม: Microsoft Power Pages มีให้ใช้งานทั่วไป (บล็อก)
ในไม่ช้าเราจะย้ายและรวมคู่มือพอร์ทัล Power Apps เข้ากับ คู่มือ Power Pages

ตัวกรองแบบไม่ตายตัวจะถูกใช้เพื่อปรับเปลี่ยนผลลัพธ์ของสตริงที่ หมายเลข ตัวแปร และออบเจ็กต์ พวกเขาจะถูกแยกออกจากค่า ไปยังที่ที่พวกเขาจะถูกนำไปใช้โดย |

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

จัดกลุ่มตาม

จัดกลุ่มรายการในอาร์เรย์ โดยแอตทริบิวต์ที่กำหนด

รหัส

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

เข้าร่วม

รวมองค์ประกอบของอาร์เรย์ ด้วยอักขระที่ถูกส่งผ่านเป็นพารามิเตอร์ ผลลัพธ์เป็นสตริงเดี่ยว

รหัส

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

เรียง_ตาม

ส่งกลับองค์ประกอบของอาร์เรย์โดยเรียงตามแอตทริบิวต์ที่กำหนดขององค์ประกอบของอาร์เรย์

อีกทางหนึ่งคือ คุณสามารถให้ คำอธิบาย เป็นพารามิเตอร์ที่สอง เพื่อจัดเรียงองค์ประกอบในลำดับจากมากไปหาน้อย แทนที่จะเป็นจากน้อยไปหามาก

รหัส

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

แบบสุ่ม

ส่งกลับรายการที่เลือกโดยการสุ่มเดี่ยวจากอาร์เรย์

รหัส

{{ group1 | join: ', ' }}

{{ group1 | random }}

ผลลัพธ์

John, Pete, Hannah

Pete

เลือก

เลือกค่าของแอตทริบิวต์ที่กำหนดสำหรับสินค้าแต่ละรายการในอาร์เรย์ และส่งกลับค่าเหล่านี้เป็นแบบอาร์เรย์

รหัส

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

ผลลัพธ์

Redmond, New York

สลับ

เมื่อนำไปใช้กับอาร์เรย์ ส่งกลับค่าอาร์เรย์ใหม่ด้วยรายการเดิม ในการเรียงลำดับแบบสุ่ม

รหัส

{{ group1 | join: ', ' }}

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

ผลลัพธ์

John, Pete, Hannah

Hannah, John, Pete

ขนาด

ส่งกลับจำนวนของรายการในอาร์เรย์

ขนาด ยังสามารถใช้กับเครื่องหมายจุดแบบพิเศษ ในกรณีที่ต้องการใช้ภายในแท็ก

รหัส

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

ข้าม

ข้ามจำนวนที่กำหนดของรายการที่อยู่ในอาร์เรย์ และส่งกลับส่วนที่เหลือ

รหัส

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

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

ผลลัพธ์

run, of, text

ใช้

ใช้จำนวนที่กำหนดของรายการจากอาร์เรย์ ที่ส่งคืนรายการที่ใช้แล้ว

รหัส

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

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

ผลลัพธ์


This, is, a

แล้ว_ตามด้วย

เพิ่มการจัดลำดับเพิ่มเติมไปยังอาร์เรย์ที่ได้ถูกเรียงลำดับแล้วโดย เรียง_ตาม

รหัส

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

ตัวกรองวันที่

ตัวกรองวันที่สามารถใช้สำหรับการคำนวณวันที่ หรือแปลงค่าวันที่และเวลาเป็นรูปแบบต่าง ๆ

วันที่

จัดรูปแบบค่าวันที่และเวลาโดยใช้สตริงรูปแบบ .NET

สตริงรูปแบบวันที่และเวลามาตรฐาน

สตริงรูปแบบวันที่และเวลาแบบกำหนดเอง

รหัส

{{ now | date: 'g' }}

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

ผลลัพธ์

5/7/2018 7:20 AM

May 07, 2018

วันที่_เพิ่ม_วัน

เพิ่มจำนวนวันทั้งหมดและที่เป็นเศษส่วนที่ระบุ ไปยังค่าวันที่และเวลา พารามิเตอร์สามารถเป็นค่าบวกหรือค่าลบ

รหัส

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

วันที่_เพิ่ม_ชั่วโมง

เพิ่มจำนวนชั่วโมงทั้งหมดและที่เป็นเศษส่วนที่ระบุ ไปยังค่าวันที่และเวลา พารามิเตอร์สามารถเป็นค่าบวกหรือค่าลบ

รหัส

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

วันที่_เพิ่ม_นาที

เพิ่มจำนวนนาทีทั้งหมดและที่เป็นเศษส่วนที่ระบุ ไปยังค่าวันที่และเวลา พารามิเตอร์สามารถเป็นค่าบวกหรือค่าลบ

รหัส

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

วันที่_เพิ่ม_เดือน

เพิ่มจำนวนเดือนทั้งหมดและที่เป็นเศษส่วนที่ระบุ ไปยังค่าวันที่และเวลา พารามิเตอร์สามารถเป็นค่าบวกหรือค่าลบ

รหัส

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

วันที่_เพิ่ม_วินาที

เพิ่มจำนวนวินาทีทั้งหมดและที่เป็นเศษส่วนที่ระบุ ไปยังค่าวันที่และเวลา พารามิเตอร์สามารถเป็นค่าบวกหรือค่าลบ

รหัส

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

วันที่_เพิ่ม_ปี

เพิ่มจำนวนปีทั้งหมดและที่เป็นเศษส่วนที่ระบุ ไปยังค่าวันที่และเวลา พารามิเตอร์สามารถเป็นค่าบวกหรือค่าลบ

รหัส

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

วันที่_เป็น_iso8601

จัดรูปแบบค่าวันที่และเวลาตามมาตรฐาน ISO 8601 มีประโยชน์เมื่อมีการสร้าง ตัวดึงข้อมูลอะตอม หรือองค์ประกอบ <เวลา> HTML5

รหัส

{{ now | date_to_iso8601 }}

ผลลัพธ์

2018-05-07T07:20:46Z

วันที่_เป็น_rfc 822

จัดรูปแบบค่าวันที่และเวลาตามมาตรฐาน RFC 822 มีประโยชน์เมื่อมีการสร้าง ตัวดึงข้อมูล RSS

รหัส

{{ now | date_to_rfc822 }}

เอาท์พุท

Mon, 07 May 2018 07:20:46 Z

ตัวกรองรายการ

มีการใช้ตัวกรองรายการในการทำงานกับค่าแอตทริบิวต์ รายการเอนทิตี บางค่า และเพื่อช่วยในการสร้างมุมมองรายการ

การเรียงลำดับ_ปัจจุบัน

นิพจน์การเรียงลำดับที่กำหนด ส่งคืนทิศทางการเรียงลำดับปัจจุบันสำหรับแอตทริบิวต์ที่กำหนด

รหัส

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

ผลลัพธ์

DESC

metafilters

แยกวิเคราะห์ค่า JSON ของคำอธิบาย_ตัวกรอง รายการเอนทิตี ลงในออบเจ็กต์กลุ่มตัวเลือกตัวกรอง

metafilters สามารถเลือกให้มีแบบสอบถามตัวกรองแอตทริบิวต์ปัจจุบันและ รายการเอนทิตี ปัจจุบันได้ ซึ่งอนุญาตให้ออบเจ็กต์ตัวกรองที่ส่งคืนถูกแฟล็กเป็นถูกเลือก หรือถูกยกเลิกการเลือกได้ อย่างใดอย่างหนึ่ง

รหัส

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

เรียงลำดับ_ย้อนกลับ

ทิศทางการเรียงลำดับที่กำหนด ส่งคืนทิศทางการเรียงลำดับที่ตรงกันข้าม

รหัส

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

หาร_ด้วย

หารตัวเลขด้วยอีกตัวเลขหนึ่ง

รหัส

{{ 10 | divided_by: 2 }}

{{ 10 | divided_by: 3 }}

{{ 10.0 | divided_by: 3 }}

ผลลัพธ์

พื้น

ปัดค่าลงไปที่จำนวนเต็มที่ใกล้ที่สุด

รหัส

{{ 4.6 | floor }}

{{ 4.3 | floor }}

ผลลัพธ์

4

4

ลบ

ลบตัวเลขออกจากอีกตัวเลขหนึ่ง

รหัส

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

ผลลัพธ์

กลม

ปัดค่าเป็นจำนวนเต็มที่ใกล้ที่สุดหรือจำนวนทศนิยมที่ระบุ

รหัส

{{ 4.6 | round }}

{{ 4.3 | round }}

{{ 4.5612 | round: 2 }}

ผลลัพธ์

คูณ

คูณตัวเลขด้วยอีกตัวเลขหนึ่ง

รหัส

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

Escape

HTML-escapes เป็นสตริง

รหัส

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

ผลลัพธ์

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

บรรทัดใหม่_เป็น_br

แทรกแท็ก HTML ตัวแบ่งบรรทัด <br /> ที่ตัวแบ่งบรรทัดแต่ละตัวในสตริง

รหัส

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

เอาออก_ก่อน

เอาสตริงย่อยที่เกิดขึ้นครั้งแรกออกจากสตริง

รหัส

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

แทนที่_ก่อน

แทนที่สตริงที่เกิดขึ้นครั้งแรกด้วยสตริงย่อย

รหัส

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

ข้อความ_เป็น_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...

ตัดคำ_ให้สั้นลง

ตัดทอนสตริงจนถึงจำนวนคำที่ระบุ จุดไข่ปลา (...) จะถูกผนวกเข้ากับสตริงที่ถูกตัดทอน

รหัส

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

ผลลัพธ์

This is a...

ตัวพิมพ์ใหญ่

แปลงสตริงเป็นตัวพิมพ์ใหญ่

รหัส

{{ 'MIxed Case TExt' | upcase }}

ผลลัพธ์

MIXED CASE TEXT

url_escape

URI-escape สตริง สำหรับการรวมใน URL

รหัส

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

ผลลัพธ์

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

xml_escape

XML-escape สตริง สำหรับการรวมในผลลัพธ์ XML

รหัส

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

ผลลัพธ์

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

พิมพ์ตัวกรอง

พิมพ์ตัวกรองช่วยให้คุณสามารถแปลงค่าชนิดใดชนิดหนึ่งเป็นชนิดอื่นๆได้

บูลีน

พยายามแปลงค่าสตริงเป็นบูลีน ถ้าค่าเป็นบูลีนเรียบร้อยแล้ว จะถูกส่งคืนแบบไม่ถูกเปลี่ยนแปลง ถ้าไม่สามารถแปลงค่าเป็นบูลีนได้ null จะถูกส่งคืน

ตัวกรองนี้จะยังยอมรับ เปิด, เปิดใช้งานแล้ว หรือ ใช่ เป็นจริง และ ปิด, ถูกปิดการใช้งาน และ ไม่ เป็นเท็จ

รหัส

{{ 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 ได้

เพิ่ม_แบบสอบถาม

ผนวกพารามิเตอร์สตริงแบบสอบถามไปยัง 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

พาธ_และ_แบบสอบถาม

ได้รับส่วนเส้นทางและการสอบถามของ 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 }}

ผลลัพธ์

ลบ_แบบสอบถาม

ลบพารามิเตอร์สตริงแบบสอบถามออกจาก 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

ขนาด_ไฟล์

เมื่อมีการนำไปใช้กับค่าตัวเลขที่แสดงถึงจำนวนไบต์ ให้ส่งคืนขนาดไฟล์ที่มีการจัดรูปแบบด้วยหน่วยของสเกลที่เหมาะสม

อีกทางหนึ่งคือ พารามิเตอร์ที่มีความแม่นยำสามารถถูกส่งผ่านได้ เพื่อควบคุมจำนวนตำแหน่งทศนิยมในผลลัพธ์ ความแม่นยำค่าเริ่มต้นคือ 1

รหัส

{{ 10000000 | file_size }}

{{ 2050 | file_size: 0 }}

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

ผลลัพธ์

9.5 MB

2 KB

207.14 KB

มี_บทบาท

เมื่อมีการนำไปใช้กับ ผู้ใช้ ให้ส่งคืน true ถ้าผู้ใช้เป็นของบทบาทที่กำหนดไว้ ส่งคืน false ถ้าไม่

รหัส

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

{% if is_admin %}

User is an administrator.

{% endif %}

ไม่ตายตัว

แสดงสตริงเป็นรหัสแบบไม่ตายตัว รหัสนี้จะมีการเข้าถึงบริบทของการดำเนินการแบบไม่ตายตัวปัจจุบัน (ตัวแปร เป็นต้น)

หมายเหตุ

ตัวกรองนี้ควรถูกใช้ด้วยความระมัดระวัง และโดยทั่วไปแล้ว ควรจะถูกใช้กับค่าที่อยู่ภายใต้การควบคุมแบบเอกสิทธิ์เฉพาะของผู้เขียนเนื้อหาพอร์ทัล หรือผู้ใช้อื่นที่สามารถเชื่อถือได้ในการเขียนรหัสแบบไม่ตายตัว

รหัส

{{ page.adx_copy | liquid }}

ดูเพิ่มเติม

เก็บเนื้อหาต้นฉบับโดยใช้เทมเพลตเว็บ
เข้าใจตัวดำเนินการแบบไม่ตายตัว ชนิดแบบไม่ตายตัว
ออบเจ็กต์แบบไม่ตายตัว
แท็กแบบไม่ตายตัว
ตัวกรองแบบไม่ตายตัว

หมายเหตุ

บอกให้เราทราบเกี่ยวกับภาษาที่คุณต้องการในคู่มือ ทำแบบสำรวจสั้นๆ (โปรดทราบว่าแบบสำรวจนี้เป็นภาษาอังกฤษ)

แบบสำรวจนี้ใช้เวลาทำประมาณเจ็ดนาที ไม่มีการเก็บข้อมูลส่วนบุคคล (คำชี้แจงสิทธิ์ส่วนบุคคล)

แชร์ผ่าน

ตัวกรอง Liquid ที่พร้อมใช้งาน

ตัวกรองอาร์เรย์

ชุดงาน

CONCAT

ยกเว้น

ที่หนึ่ง

จัดกลุ่มตาม

เข้าร่วม

สุดท้าย

เรียง_ตาม

แบบสุ่ม

เลือก

สลับ

ขนาด

ข้าม

ใช้

แล้ว_ตามด้วย

ที่ซึ่ง

ตัวกรองวันที่

วันที่

วันที่_เพิ่ม_วัน

วันที่_เพิ่ม_ชั่วโมง

วันที่_เพิ่ม_นาที

วันที่_เพิ่ม_เดือน

วันที่_เพิ่ม_วินาที

วันที่_เพิ่ม_ปี

วันที่_เป็น_iso8601

วันที่_เป็น_rfc 822

ตัวกรองรายการ

การเรียงลำดับ_ปัจจุบัน

metafilters

เรียงลำดับ_ย้อนกลับ

ตัวกรองเครื่องหมายคณิตศาสตร์

ceil

หาร_ด้วย

พื้น

ลบ

modulo

บวก

กลม

คูณ

ตัวกรองสตริง

ผนวก

ทำให้เป็นตัวพิมพ์ใหญ่

ตัวพิมพ์เล็ก

Escape

บรรทัดใหม่_เป็น_br

เพิ่ม

เอาออก

เอาออก_ก่อน

แทนที่

แทนที่_ก่อน

แบ่ง

strip_html

strip_newlines

ข้อความ_เป็น_html

ตัดให้สั้นลง

ตัดคำ_ให้สั้นลง

ตัวพิมพ์ใหญ่

url_escape

xml_escape

พิมพ์ตัวกรอง

บูลีน

เลขทศนิยม

จำนวนเต็ม

สตริง

ตัวกรอง URL

เพิ่ม_แบบสอบถาม

พื้นฐาน

โฮสต์

พาธ

พาธ_และ_แบบสอบถาม

พอร์ต

ลบ_แบบสอบถาม

แบบแผน

ตัวกรองเพิ่มเติม

ค่าเริ่มต้น

ขนาด_ไฟล์

มี_บทบาท