v10.21.0
+ +Return the 0-based index of the first object in an array for which the queried attribute has the given value or return nil if no item in the array satisfies the given criteria. For the following members array:
const members = [
+ { graduation_year: 2013, name: 'Jay' },
+ { graduation_year: 2014, name: 'John' },
+ { graduation_year: 2014, name: 'Jack' }
+]Input
+{{ members | find_index: "graduation_year", 2014 | json }}Output
+1v10.21.0
+ +Return the 0-based index of the first object in an array for which the given expression evaluates to true or return nil if no item in the array satisfies the evaluated expression.
const members = [
+ { graduation_year: 2013, name: 'Jay' },
+ { graduation_year: 2014, name: 'John' },
+ { graduation_year: 2014, name: 'Jack' }
+]Input
+{{ members | find_index_exp: "item", "item.graduation_year == 2014" | json }}Output
+1v10.21.0
+ +Return true if the array includes an item for which the queried attribute has the given value or return false if no item in the array satisfies the given criteria. For the following members array:
const members = [
+ { graduation_year: 2013, name: 'Jay' },
+ { graduation_year: 2014, name: 'John' },
+ { graduation_year: 2014, name: 'Jack' }
+]Input
+{{ members | has: "graduation_year", 2014 | json }}Output
+truev10.21.0
+ +Return true if an item exists in an array for which the given expression evaluates to true or return false if no item in the array satisfies the evaluated expression.
const members = [
+ { graduation_year: 2013, name: 'Jay' },
+ { graduation_year: 2014, name: 'John' },
+ { graduation_year: 2014, name: 'Jack' }
+]Input
+{{ members | has_exp: "item", "item.graduation_year == 2014" | json }}Output
+truev10.21.0
+ +Creates an array excluding the objects with a given property value, or excluding truthy values by default when a property is not given.
+In this example, assume you have a list of products and you want to filter out kitchen products. Using reject, you can create an array excluding only the products that have a "type" of "kitchen".
Input
+All products:
+{% for product in products %}
+- {{ product.title }}
+{% endfor %}
+
+{% assign non_kitchen_products = products | reject: "type", "kitchen" %}
+
+Kitchen products:
+{% for product in non_kitchen_products %}
+- {{ product.title }}
+{% endfor %}Output
+All products:
+- Vacuum
+- Spatula
+- Television
+- Garlic press
+
+Kitchen products:
+- Vacuum
+- TelevisionSay instead you have a list of products and you want to exclude taxable products. You can reject with a property name but no target value to reject all products with a truthy "taxable" value.
Input
+All products:
+{% for product in products %}
+- {{ product.title }}
+{% endfor %}
+
+{% assign not_taxed_products = products | reject: "taxable" %}
+
+Available products:
+{% for product in not_taxed_products %}
+- {{ product.title }}
+{% endfor %}Output
+All products:
+- Vacuum
+- Spatula
+- Television
+- Garlic press
+
+Available products:
+- Spatula
+- TelevisionAdditionally, property can be any valid Liquid variable expression as used in output syntax, except that the scope of this expression is within each item. For the following products array:
const products = [
+ { meta: { details: { class: 'A' } }, order: 1 },
+ { meta: { details: { class: 'B' } }, order: 2 },
+ { meta: { details: { class: 'B' } }, order: 3 }
+]Input
+{% assign selected = products | reject: 'meta.details["class"]', "B" %}
+{% for item in selected -%}
+- {{ item.order }}
+{% endfor %}Output
+- 1v10.21.0
+ +For Liquid users migrating from Jekyll, there’s a jekyllWhere option to mimic the behavior of Jekyll’s where filter. This option is set to false by default. When enabled, if property is an array, the target value is matched using Array.includes instead of ==, which is particularly useful for excluding tags.
const pages = [
+ { tags: ["cat", "food"], title: 'Cat Food' },
+ { tags: ["dog", "food"], title: 'Dog Food' },
+]Input
+{% assign selected = pages | reject: 'tags', "cat" %}
+{% for item in selected -%}
+- {{ item.title }}
+{% endfor %}Output
+Dog Foodv10.21.0
+ +Select all the objects in an array where the expression is false. In this example, assume you have a list of products and you want to hide your kitchen products. Using reject_exp, you can create an array that omits only the products that have a "type" of "kitchen".
Input
+All products:
+{% for product in products %}
+- {{ product.title }}
+{% endfor %}
+
+{% assign non_kitchen_products = products | reject_exp: "item", "item.type == 'kitchen'" %}
+
+Kitchen products:
+{% for product in non_kitchen_products %}
+- {{ product.title }}
+{% endfor %}Output
+All products:
+- Vacuum
+- Spatula
+- Television
+- Garlic press
+
+Kitchen products:
+- Vacuum
+- TelevisionSay instead you have a list of products and you only want to show those that are available to buy. You can where with a property name but no target value to include all products with a truthy "available" value.
Say instead you have a list of products and you only want to show those that are available to buy. You can where with a property name but no target value to include all products with a truthy "available" value.
As a special case, the same will happen if the target value is given but evaluates to undefined.
Input
All products:
{% for product in products %}
@@ -147,8 +147,7 @@ Available products:
The where filter can also be used to find a single object in an array when combined with the first filter. For example, say you want to show off the shirt in your new fall collection.
Input
{% assign new_shirt = products | where: "type", "shirt" | first %}
-
-Featured product: {{ new_shirt.title }}
+Featured product: {{ new_shirt.title }}Output
Featured product: Hawaiian print sweater vest- 2
- 3
-v10.19.0
+v10.21.0
-For Liquid users migrating from Jekyll, there’s a jekyllWhere option to mimic the behavior of Jekyll’s where filter. This option is set to false by default. When enabled, if property is an array, the target value is matched using Array.includes instead of ==, which is particularly useful for filtering tags.
For Liquid users migrating from Jekyll, there’s a jekyllWhere option to mimic the behavior of Jekyll’s where filter. This option is set to false by default. When enabled, if property is an array, the target value is matched using Array.includes instead of ==, which is particularly useful for filtering tags. Additionally, a target value of undefined is treated normally, entries matched are exactly those which are themselves undefined.
This option affects other array selection filters as well, such as reject and find.
const pages = [
{ tags: ["cat", "food"], title: 'Cat Food' },
{ tags: ["dog", "food"], title: 'Dog Food' },
@@ -190,7 +190,7 @@ Featured product:
-
+
PrevNext
size, first, last support arraylike objects, #781 (35a8442)lenientIf for multiple operands (issue #682) (#683) (490ff43)newline_to_br and strip_newlines (88aa63f)strictVariables (8af682d)size, first, last support arraylike objects, #781 (35a8442)lenientIf for multiple operands (issue #682) (#683) (490ff43)newline_to_br and strip_newlines (88aa63f)strictVariables (8af682d)