可用的 Liquid 筛选器 - Power Apps | Microsoft Learn

link之家
链接快照平台
输入网页链接，自动生成快照
标签化管理网页链接
相关文章推荐
潇洒的机器猫 · 「电脑软件」动漫电影MKV格式快速无损转换M ...· 1 周前 ·
很拉风的酱牛肉 · 李祥庭-幽居(古琴独奏)[正版CD原抓WAV ...· 1 周前 ·
礼貌的领带 · ubuntu ...· 4 天前 ·
沉稳的麻辣香锅 · 请回答我1988网盘 - 百度· 3 天前 ·
爱逃课的啤酒 · webp ...· 2 天前 ·
谦虚好学的消防车 · Power Query Essbase ...· 2 月前 ·
道上混的创口贴 · 鼠标移出移入、 ...· 1 年前 ·
发呆的地瓜 · Linux 网络工具详解之 ip ...· 1 年前 ·
强健的生姜 · Boost.Asio 中 ...· 1 年前 ·
从 2022 年 10 月 12 日起，Power Apps 门户更名为 Power Pages。详细信息请参阅： Microsoft Power Pages 现已正式发布（博客）
不久后我们将迁移 Power Apps 门户文档并将其与 Power Pages 文档合并在一起。
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 %}
{% for item in batch %}
<li>{{ item.fullname }}</li>
{% endfor %}
{% endfor %}
<li>John Smith</li>
<li>Dave Thomas</li>
<li>Jake Johnson</li>
<li>Jack Robinson</li>
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
except
选择指定属性没有指定值的数组中的所有对象。 （这与 where 相反。）
{% assign redmond = entityview.records | except: 'address1_city', 'Redmond' %}
{% for item in redmond %}
{{ item.fullname }}
{% endfor %}
Jack Robinson
返回数组的第一个元素。
在需要在标记内使用 first 时，也可以使用特殊点符号。
{% assign words = This is a run of text | split:   %}
{{ words | first }}
{% if words.first == This %}
The first word is This.
{% endif %}
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
将数组的元素与作为参数传递的字符结合。 结果是一个字符串。
{% assign words = This is a run of text | split:   %}
{{ words | join: ,  }}
This, is, a, run, of, text
返回数组的最后一个元素。
在需要在标记内使用 last 时，也可以使用特殊点符号。
{% assign words = This is a run of text | split:   -%}
{{ words | last }}
{% if words.last == text -%}
The last word is text.
{% endif -%}
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
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 -%}
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
then_by
将其他后续排序添加到已按 order_by 排序的数组。
或者，您可以提供 desc 作为第二个参数来以降序排序元素，而不是升序。
{{ 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 格式字符串确定 DateTime 值的格式。
标准日期和时间格式字符串
自定义日期和时间格式字符串
{{ 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
根据 ISO 8601 标准确定 DateTime 值的格式。 在创建 Atom 源或 HTML5 <time> 元素时有用。
{{ now | date_to_iso8601 }}
2018-05-07T07:20:46Z
date_to_rfc822
根据 RFC 822 标准确定 DateTime 值的格式。 在创建 RSS 源时有用。
{{ now | date_to_rfc822 }}
Mon, 07 May 2018 07:20:46 Z
列表筛选器
列表筛选器用于处理某些 entitylist 属性值，并帮助创建列表视图。
current_sort
指定的排序表达式，返回指定属性的当前排序方向。
{{ 'name ASC, createdon DESC' | current_sort: 'createdon' }}
metafilters
将 entitylist filter_definition JSON 值解析为筛选器选项组对象。
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 }}
          {% 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 }} />
              {% 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>
              {% endif %}
          {% endfor %}
    {% endfor %}
  <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 }}
数学筛选器
数学筛选器允许您对数字执行数学运算。
与所有筛选器一样，数学筛选器可以累积并按从左到右的顺序进行应用。
{{ 10 | times: 2 | minus: 5 | divided_by: 3 }}
将值四舍五入到最接近的整数。
{{ 4.6 | ceil }}
{{ 4.3 | ceil }}
divided_by
用另一个数除以某个数。
{{ 10 | divided_by: 2 }}
{{ 10 | divided_by: 3 }}
{{ 10.0 | divided_by: 3 }}
3.333333
将值四舍五入到最接近的整数。
{{ 4.6 | floor }}
{{ 4.3 | floor }}
从另一个数中减去一个数。
<!-- entityview.page = 11 -->
{{ entityview.page | minus: 1 }}
{{ 10 | minus: 1.1 }}
{{ 10.1 | minus: 1 }}
用另一个数除以某个数，并返回余数。
{{ 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
大写字符串的第一个字词。
{{ 'capitalize me' | capitalize }}
Capitalize Me
downcase
将字符串转换为小写。
{{ 'MIxed Case TExt' | downcase }}
mixed case text
escape
HTML 换码字符串。
{{ '<p>test</p>' | escape }}
&lt;p&gt;test&lt;/p&gt;
newline_to_br
在字符串的每个换行符处插入 <br /> 换行 HTML 标记。
{% capture text %}
{% endcapture %}
{{ text | newline_to_br }}
A<br />
B<br />
C<br />
prepend
预置字符串到其他字符串开头。
{{ 'Jane Johnson' | prepend: 'Dr. ' }}
Dr. Jane Johnson
remove
从字符串中移除所有出现的子串。
{{ '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?
replace
替换所有出现的含子串的字符串。
{{ '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?
split
split 筛选器将子串作为参数。 子串用作分隔符将字符串划分到数组。
{% 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 %}
{% endcapture %}
{{ text | strip_newlines }}
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>
truncate
将字符串截断为指定数量的字符。 省略号 (...) 追加到字符串并包括在字符数内。
{{ '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...
upcase
将字符串转换为大写。
{{ 'MIxed Case TExt' | upcase }}
MIXED CASE TEXT
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;
类型筛选器
类型筛选器允许您将一个类型的值转换为其他类型。
boolean
尝试将字符串值转换为布尔值。 如果值已是布尔值，它将不做更改返回。 如果值不能转换为布尔值，将返回 null。
该筛选器还会接受“打开”、“已启用”或“是”为 true，“关闭”、“禁用“和“否”为 false。
{{ true | boolean }}
{{ 'false' | boolean }}
{{ 'enabled' | boolean }}
{{ settings['something/enabled'] | boolean | default: false }}
false
false
decimal
尝试将字符串值转换为十进制数。 如果值已是十进制数，它将不做更改返回。 如果值不能转换为十进制数，将返回 null。
{{ 10.1 | decimal }}
{{ '3.14' | decimal }}
{{ 'text' | decimal | default: 3.14 }}
integer
尝试将字符串值转换为整数。 如果值已是整数，它将不做更改返回。 如果值不能转换为整数，将返回 null。
{{ 10 | integer }}
{{ '10' | integer }}
{{ '10.1' | integer }}
{{ 'text' | integer | default: 2 }}
string
尝试将字符串值转换为其字符串表示形式。 如果值已是字符串，它将不做更改返回。 如果值为 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。
如果此筛选器应用于整个绝对 URL，则将生成更新的绝对 URL。 如果将其应用于路径，则将生成更新的路径。
{{ 'https://example.com/path?page=1' | remove_query: 'page' }}
{{ '/path?page=1' | remove_query: 'page' }}
https://example.com/path
/path
scheme
获取 URL 的架构部分。
{{ 'https://example.com/path?foo=bar&page=2' | scheme }}
{{ 'https://example.com/path?foo=bar&page=2' | scheme }}
https
其他筛选器
这些筛选器提供有用的常规功能。
default
返回所有没有分派值（即 null）的变量的默认值。
{{ snippets[Header] | default: 'My Website' }}
<!-- If a snippet with the name Header returns null -->
My Website
file_size
适用于表示多个字节的数字值，使用适当比例单位返回已设定格式的文件大小。
有时，精度参数可以传递，用以控制结果中的小数位数。 默认精度为 1。
{{ 10000000 | file_size }}
{{ 2050 | file_size: 0 }}
{{ entity.notes.first.filesize | file_size: 2 }}
9.5 MB
207.14 KB
has_role
应用于 user，如果用户属于指定角色返回 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 }}
使用 Web 模板存储源内容

了解 Liquid 运算符
Liquid 类型

Liquid 对象

Liquid 标记

Liquid 筛选器
您能告诉我们您的文档语言首选项吗？ 进行简短调查。（请注意，此调查是英文版调查）
此调查大约需要七分钟。 不会收集个人数据（隐私声明）。