---
id: "filter-settings"
title: "筛选设置与折叠边界"
category: "列表工具"
document_type: "component-specification"
spec_status: "local-current-draft"
element_ui: "2.15.6"
vue: "2.6.14"
page: "../index.html#spec-filter-settings"
source_data: "../component-data.json"
official_components: []
template_components: ["el-button"]
scenario_count: 7
verification: "scenario-checklist-not-full-test-pass"
---

# 筛选设置与折叠边界

专题 `filter-settings` · 列表工具 · Element UI 2.15.6

## 适用范围与组件映射

公共色板及字体基线适用于整个运营后台。本库整理基础组件、组件状态和可复用的组合模式；本轮补齐表单整体验证、页面布局和导航组合；具体业务字段与跨页流程仍在业务场景中说明。专题验收清单包含接入要求，不表示当前示例已实现或已验证全部场景。

本专题为基础规则、同一组件的补充场景或组合模式，不作为独立的 Element UI 官方组件声明。

本页模板直接使用的 Element UI 标签：`el-button`。

## 通用基线

- 组件库：Element UI **2.15.6**；运行样例 Vue **2.6.14**。
- 系统中文字体：macOS 优先苹方，Windows 通常微软雅黑；工程顺序固定为 `"PingFang SC", "Microsoft YaHei", sans-serif`。不要求安装或加载网络字体，兼容回退不是另一套可选样式。
- 后续仅采用经验证且固定版本的兼容 Element UI 2.x；Element Plus 属于独立迁移路线。
- 正文、数据值、输入及已选值：`14px / 400 / 21px`，`#303133`。
- 表头及组件分组标题：`14px / 600 / 21px`；弹窗标题：`16px / 600 / 24px`，均使用 `#303133`。
- 辅助说明：`12px / 400 / 18px`，`#595959`；错误、链接、状态、禁用与占位按各自语义处理。
- 适用组件的默认尺寸为 `small / 32px`；不得将这一高度机械应用于表格、文本域、浮层等全部组件。
- 规范正文与场景说明使用 `14px / 400 / 24px`、`#303133`，不降成灰蓝小字。
- 筛选文本输入占位统一“请输入”；未选择下拉统一“请选择”；默认全部的下拉显示“全部”。字段标签保留业务含义；日期保留开始/结束语义。
- 次级文字操作（查看更多、编辑、详情、数据中心、更多）：`12px / 400 / 18px`，`#3377BB`；保留点击热区。
- 本规范库的深色目录、蓝色展示区属于文档排版，不是业务组件颜色或业务导航规范。

## 本页用法与分类

默认用法：默认用于设置哪些筛选字段可见：打开后修改草稿，确认才应用，取消保留原设置。

| 区分什么 | 本页内容 | 选用或触发条件 |
| --- | --- | --- |
| 用途 | 管理筛选字段是否显示，不是填写业务查询条件。 | 需要增减可见筛选字段时使用；查询值的输入仍由对应表单控件完成。 |
| 功能配置 | 全选、恢复默认、锁定项和排序分别是设置能力。 | 本页采用字段选择、全选、恢复默认、确认和取消；锁定项、排序及两行折叠只有宿主确有需要并实现后才验收。 |
| 数据状态 | 未确认草稿与已应用设置是不同数据阶段，锁定项由配置限制。 | 勾选只更新草稿，确认后才改变已应用设置；禁用和锁定不作为可选配色。 |
| 内容布局 | 单行或带说明的两行取决于字段内容；长列表在面板内滚动。 | 字段需要解释时增加第二行说明；根据真实可用空间决定滚动或宿主折叠，不缩小正文字号。 |

使用边界：不要把已勾选、锁定、展开或已应用列成几种视觉样式；本页未提供的排序和折叠不写成已实现。

## 组件规则

- **FILTER-SETTINGS-R01**：这里只规范设置组件，不设计业务筛选表单。顶部“全选 / 恢复默认”，底部“取消 / 确认”；长列表在弹窗内滚动。
- **FILTER-SETTINGS-R02**：筛选字段的宽度统一引用输入框专题；本页只管理显隐设置，显示、隐藏或恢复默认不改变同类字段的280px整项合同及日期/金额范围各自宽度口径。
- **FILTER-SETTINGS-R03**：字段显隐与查询值是不同状态；隐藏后保留还是清除查询值须由业务合同明确，组件不得偷偷改变。
- **FILTER-SETTINGS-R04**：接入时如需字段排序，可采用移动按钮或带键盘替代方式的拖拽；如需两行折叠，按真实可用空间计算并让动作区参与占位。本页只演示字段选择、确认与取消，排序和折叠由宿主实现。
- **FILTER-SETTINGS-R05**：筛选文本输入默认占位“请输入”，未选择的下拉默认“请选择”，默认全部的下拉为“全部”；保留字段标签、日期开始/结束提示，不将占位文案当作实际筛选值。
- **FILTER-SETTINGS-R06**：【公共用色】颜色仅从公共色值 引用：主色系 3 个基础色值、辅助功能色 3 个、中性色 10 个，共 16 个基础色值。角色可以多个，实际色值复用；不为每个组件、悬停 或不同字段再新增近似颜色。透明效果仅限遮罩 35% 与阴影 12%，从 外壳深色 派生。
- **FILTER-SETTINGS-R07**：【统一字体】统一系统中文字体：macOS 优先苹方（PingFang SC），Windows 通常使用微软雅黑（Microsoft YaHei）；工程顺序固定为 "PingFang SC", "Microsoft YaHei", sans-serif。使用设备已有字体，不要求安装或加载网络字体；最后一项仅作兼容回退，不是供页面作者任选的另一套样式。正文 14px/400/21px；表头与分组标题 14px/600/21px，弹窗标题 16px/600/24px；次级文字操作和辅助说明 12px/400/18px。正文与标题同用 #303133；不通过额外加粗或透明度改变正文轻重。
- **FILTER-SETTINGS-R08**：【叠加优先级】状态叠加规则：禁用阻断交互；输入类控件错误边框覆盖蓝色聚焦边框；输入框不叠加外圈或阴影，其他无边框操作保留键盘焦点提示；选中底覆盖悬停底；只读不等于禁用；加载不等于成功；业务启用/停用的文字结果不等于控件是否可点击。
- **FILTER-SETTINGS-R09**：【设置面板】白底、正文深灰，分组标题600字重，边框灰与分隔灰；分组不随机增加底色。
- **FILTER-SETTINGS-R10**：【条件选择】勾选标记主题蓝；已生效条件标签选中浅蓝底和操作蓝文字；草稿勾选不冒充已经应用。
- **FILTER-SETTINGS-R11**：【展开与收起】查看更多、收起使用操作蓝、12px/400；展开只改变内容和箭头，不把整个面板填蓝。
- **FILTER-SETTINGS-R12**：【应用与不可用】应用按钮按按钮规范；不可编辑条件使用禁用灰并保留原因；空条件说明为空值灰，不等于失败。
- **FILTER-SETTINGS-R13**：【组件边界】筛选设置容器不自带选中或错误颜色；条件复选、折叠入口和应用动作分别服从对应组件。
- **FILTER-SETTINGS-R14**：带补充说明的选项分为两行：字段名称14px/400/21px，说明12px/400/18px、辅助深灰，间隔4px；复选框对齐字段名称第一行，不能下沉到说明旁。选中只改变适用状态颜色，不改变字号或字重。
- **FILTER-SETTINGS-R15**：【关闭事件】确认、用户取消和程序关闭分别处理：确认后关闭不能再触发取消或回滚；用户一次取消只处理一次。关闭生命周期回调不等于用户取消。提交期间能否关闭及草稿去留按实际组件约定执行。

## 场景与验收清单

以下为需核对的场景组；`[ ]` 不代表已经测试通过。

- [ ] **FILTER-SETTINGS-S01**：当前示例：字段显示项、全选和恢复默认都只修改草稿；确认应用，取消保留此前已应用值。
- [ ] **FILTER-SETTINGS-S02**：接入验收：宿主增加系统锁定项或长列表时，再核对锁定限制和内部滚动；当前基础示例没有锁定项和长列表。
- [ ] **FILTER-SETTINGS-S03**：接入验收：排序、持久化作用域和两行折叠由宿主实现；按真实宽度计算，动作区也参与占位。
- [ ] **FILTER-SETTINGS-S04**：接入验收：隐藏查询值保留或清除的策略必须明确，避免不可见条件影响结果却无提示。
- [ ] **FILTER-SETTINGS-S05**：当前示例核对单行字段名称14px与复选框对齐；宿主增加说明时采用名称14px、说明12px、间隔4px，并与名称首行对齐。选中、取消和禁用不改变字号或对齐。
- [ ] **FILTER-SETTINGS-S06**：宽度联动验收：按输入框专题核对整项与边框口径、同组对齐、长内容、窄容器换行及状态不跳宽。
- [ ] **FILTER-SETTINGS-S07**：接入验收：分别检查确认、取消、叉号、Esc、遮罩及父级程序关闭；一次动作只产生一次对应业务结果，确认后不误发取消，禁用的关闭入口不能执行。

### 专题验收重点

修改、全选与恢复默认只更新草稿；取消不影响已应用值，确认才应用。锁定项、排序、持久化和两行折叠属于宿主接入验收项。

## 当前示例模板

以下来自本专题的结构化示例，使用 Vue 2 模板语法。`v-model`、事件方法、数据列表等依赖 [components.js](../components.js)；完整样式文件及加载顺序见 [通用基线](FOUNDATIONS.md)。自定义组合标签的内部实现由下方依赖文件提供，不能仅复制标签作为完整组件。

```html
<el-button @click="openSettings">打开筛选设置</el-button>
<p class="help">已应用：{{savedSettings.join(' / ') || '无'}}</p>
```

## 交付与使用边界

- 规范条款、示例代码与待验收场景分开理解；有示例不等于已覆盖所有样式、交互状态和使用场景。
- 业务接口、权限、时区、金额精度、数据规模等依赖应从实际项目读取，不使用演示值代替生产约定。
- 发生样式或文案变更时，同步专题数据、页面与 Markdown，避免规范和样例分离。

## 来源与关联

- 来源线索：历史样板规范 1 / 2 / 56；当前规则索引。
- [打开本专题页面](../index.html#spec-filter-settings)
- [通用基线](FOUNDATIONS.md)
- [规范总索引](README.md)
- [结构化规范数据](../component-data.json)（记录 id：`filter-settings`）
- [原始历史样板](../original-20260621.html)
- [历史规范条目](../spec-notes.json)

## 本组件颜色状态表

| 状态 / 条件 | 统一规则 |
| --- | --- |
| 设置面板 | 白底、正文深灰，分组标题600字重，边框灰与分隔灰；分组不随机增加底色。 |
| 条件选择 | 勾选标记主题蓝；已生效条件标签选中浅蓝底和操作蓝文字；草稿勾选不冒充已经应用。 |
| 展开与收起 | 查看更多、收起使用操作蓝、12px/400；展开只改变内容和箭头，不把整个面板填蓝。 |
| 应用与不可用 | 应用按钮按按钮规范；不可编辑条件使用禁用灰并保留原因；空条件说明为空值灰，不等于失败。 |

筛选设置容器不自带选中或错误颜色；条件复选、折叠入口和应用动作分别服从对应组件。

[公共颜色与字体 token](../color-tokens.json) · [公共组件样式](../color-contract.css) · [系统字体合同（最后加载）](../font-contract.css)

## 业务落地场景

- [会员列表 · 列表工具区 · 筛选设置](../../showcase/index.html#members) · [场景文档](../../showcase/docs/members.md)
- [取款审核 · 取款列表 · 筛选设置](../../showcase/index.html#withdrawals) · [场景文档](../../showcase/docs/withdrawals.md)

[竞品组件拆解](../../reference-review/竞品组件反推规范.html) · [业务场景分类](../../业务场景分类清单.md)