---
title: "页面筛选器与联动"
description: "筛选器块（Filter Block）统一输入筛选条件，自动合并到图表查询，实现多图一致筛选与联动刷新，支持 Builder/SQL 模式。"
keywords: "页面筛选器,Filter Block,筛选联动,图表联动,多图筛选,NocoBase"
---

# 页面筛选器与联动

页面筛选器（Filter Block）用于在页面级统一输入筛选条件，并将其合并到图表查询中，实现多图一致的筛选与联动。

## 功能概览
- 在页面上添加“筛选器块”，为当前页面的所有图表提供统一的筛选入口。
- 通过“筛选”“重置”“折叠”按钮进行应用、清空与收起操作。
- 筛选器中如果选择关联了图表的字段，它值自动将合并到图表的查询请求中，触发图表刷新。
- 筛选器也可创建自定义字段，在上下文变量中注册，在图表、表格、表单等数据区块中可以选择引用。

![clipboard-image-1761487702](https://static-docs.nocobase.com/clipboard-image-1761487702.png)

更多关于页面筛选器的用法，以及与图表等数据区块的联动，请参考 页面筛选器 文档。

## 在图表查询中使用页面筛选值
- Builder 模式（推荐）
  - 自动合并：同数据源&集合时，无需在图表查询中额外写变量，页面筛选会以 `$and` 合并。
  - 手动选择：也可以在过滤条件中主动选择页面筛选器“自定义字段”的值。

- SQL 模式（通过变量注入）
  - 在 SQL 语句中 “选择变量” 插入页面筛选器“自定义字段”的值。
