# filter

> filter Liquid 对象：表示 Shoplazza Theme 中的一个店面筛选项，含在专辑页或搜索页渲染它所需的属性。

店面 filter。

要了解如何在主题中支持 filters，请参阅[支持店面筛选](/docs/theme/theme-features/site-navigation-and-search/filtering/support-storefront-filtering)。

| Properties        | Type                                       | Description                                                                                                                                  |
| :---------------- | :----------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------- |
| `active_values`   | array of [filter\_value](./filter_value) | 当前处于激活状态的 filter 值。                                                                                          |
| `inactive_values` | array of [filter\_value](./filter_value) | 当前处于非激活状态的 filter 值，该数组仅适用于 `list` 类型的 filters。                            |
| `label`           | [string](../basics/liquid-types#string)        | 面向客户显示的 filter 标签。                                                                                                    |
| `max_value`       | [filter\_value](./filter_value)          | 最高 filter 值，仅适用于 `price_range` 类型的 filters；其他类型返回 `nil`。                                |
| `min_value`       | [filter\_value](./filter_value)          | 最低 filter 值，仅适用于 `price_range` 类型的 filters；其他类型返回 `nil`。                                 |
| `param_name`      | [string](../basics/liquid-types#string)        | filter 的 URL 参数，例如 `filter.v.option.color`。                                                                      |
| `range_max`       | [number](../basics/liquid-types#number)        | collection 结果中最高的商品价格，仅适用于 `price_range` 类型的 filters；其他类型返回 `nil`。 |
| `range_min`       | [number](../basics/liquid-types#number)        | collection 结果中最低的商品价格，仅适用于 `price_range` 类型的 filters；其他类型返回 `nil`。  |
| `type`            | [string](../basics/liquid-types#string)        | filter 的类型。可选值：`list`、`price_range`。                                                                                   |
| `url_to_remove`   | [string](../basics/liquid-types#string)        | 已移除该 filter 相关 URL 参数的当前页面 URL。                                                                |
| `values`          | array of [filter\_value](./filter_value) | filter 的值，该数组仅适用于 `list` 类型的 filters。                                                        |

```json title="对象"
{
  "label": "availability",
  "param_name": "filter.v.availability",
  "type": "list",
  "range_min": 0,
  "range_max": 0,
  "values": [
    {
      "param_name": "filter.v.availability",
      "label": "1",
      "value": "1",
      "active": false,
      "count": 137
    },
    {
      "param_name": "filter.v.availability",
      "label": "0",
      "value": "0",
      "active": false,
      "count": 4
    }
  ],
  "active_values": null,
  "inactive_values": [
    {
      "param_name": "filter.v.availability",
      "label": "1",
      "value": "1",
      "active": false,
      "count": 137
    },
    {
      "param_name": "filter.v.availability",
      "label": "0",
      "value": "0",
      "active": false,
      "count": 4
    }
  ],
  "max_value": null,
  "min_value": null,
  "url_to_remove": "/collections/all-collections?="
}
```