--- id: "popconfirm" title: "气泡确认" category: "浮层组件" document_type: "component-specification" spec_status: "local-current-draft" element_ui: "2.15.6" vue: "2.6.14" page: "../index.html#spec-popconfirm" source_data: "../component-data.json" official_components: ["popconfirm"] template_components: [] scenario_count: 7 verification: "scenario-checklist-not-full-test-pass" --- # 气泡确认 专题 `popconfirm` · 浮层组件 · Element UI 2.15.6 ## 适用范围与组件映射 公共色板及字体基线适用于整个运营后台。本库整理基础组件、组件状态和可复用的组合模式；本轮补齐表单整体验证、页面布局和导航组合；具体业务字段与跨页流程仍在业务场景中说明。专题验收清单包含接入要求，不表示当前示例已实现或已验证全部场景。 官方条目映射：`popconfirm`。 ## 通用基线 - 组件库：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`；保留点击热区。 - 本规范库的深色目录、蓝色展示区属于文档排版，不是业务组件颜色或业务导航规范。 ## 本页用法与分类 默认用法：仅用于轻量、非删除的局部设置确认；本页以恢复默认列设置为例，打开后焦点进入取消按钮。 | 区分什么 | 本页内容 | 选用或触发条件 | | --- | --- | --- | | 用途边界 | 恢复默认等轻量设置可用气泡确认；删除、移除统一用居中确认弹窗。 | 后果能在短文案中说清，且不删除对象时才考虑气泡；复杂说明或输入任务使用对话框。 | | 草稿与生效 | 恢复当前草稿与保存到实际展示是两个步骤，不是两种气泡样式。 | 规范示例直接恢复本地列选择；存款记录先恢复列设置草稿，再点击保存应用到表格，取消保留草稿。 | | 自动交互状态 | 打开、取消、确认与关闭由用户操作触发。 | 当前例子不发起后台请求，不展示虚构的处理中或失败；确认、取消、退出键及外部关闭按各自结果处理焦点。 | 使用边界：气泡与居中弹窗不是可随意替换的皮肤；删除、移除不使用气泡，也不以对象未保存为由跳过确认。 ## 组件规则 - **POPCONFIRM-R01**：仅用于轻量、局部、非删除的设置确认，例如恢复默认列设置。删除、移除统一使用居中确认弹窗；复杂或需要输入的任务使用对话框。 - **POPCONFIRM-R02**：确认文本表达具体动作，取消不执行；按退出键（Esc）或点击外部关闭均不执行确认动作。打开后焦点进入取消按钮；确认、取消或按退出键主动关闭后回到原入口，点击外部关闭时保留新点击目标的焦点。 - **POPCONFIRM-R03**：气泡不能被列表或滚动容器裁切；定位需保持在视口内并避开关键操作。同屏避免多个确认气泡同时展开。 - **POPCONFIRM-R04**：【公共用色】颜色仅从公共色值 引用：主色系 3 个基础色值、辅助功能色 3 个、中性色 10 个，共 16 个基础色值。角色可以多个，实际色值复用；不为每个组件、悬停 或不同字段再新增近似颜色。透明效果仅限遮罩 35% 与阴影 12%，从 外壳深色 派生。 - **POPCONFIRM-R05**：【统一字体】统一系统中文字体：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；不通过额外加粗或透明度改变正文轻重。 - **POPCONFIRM-R06**：【叠加优先级】状态叠加规则：禁用阻断交互；输入类控件错误边框覆盖蓝色聚焦边框；输入框不叠加外圈或阴影，其他无边框操作保留键盘焦点提示；选中底覆盖悬停底；只读不等于禁用；加载不等于成功；业务启用/停用的文字结果不等于控件是否可点击。 - **POPCONFIRM-R07**：恢复默认是普通设置动作，入口使用12px/400操作蓝文字，无框透明底；悬停加下划线并保留键盘焦点。不要把它标成红色删除入口。 - **POPCONFIRM-R08**：删除、移除统一先打开居中确认弹窗，明确对象、数量和后果；确认按钮统一写“确认”，取消不改变数据。未保存项、待上传附件、已保存记录和批量删除都沿用这一入口规则；失败保留原内容和重试入口。普通清空输入、取消筛选或关闭弹层不是删除，不自动标红。 - **POPCONFIRM-R09**：【气泡内容】白底、正文深灰、边框灰与公共阴影；普通设置说明可使用主题蓝信息图标，不使用删除风险图标。气泡自身不增加页面遮罩。 - **POPCONFIRM-R10**：【触发入口】轻量非删除操作使用操作蓝、12px/400、无框透明底，并保留键盘焦点；删除和移除的红字入口转到居中确认弹窗。 - **POPCONFIRM-R11**：【确认与取消】正文说明要执行的具体动作，按钮统一显示“确认”和“取消”；确认使用主按钮，取消使用普通按钮。取消、退出键和外部关闭均不修改设置。 - **POPCONFIRM-R12**：【关闭与后续处理】本地恢复默认在确认后立即更新设置草稿；业务列设置仍需保存后才作用于表格。确认、取消或按退出键主动关闭后回到触发器，点击外部关闭时保留新点击目标的焦点。 - **POPCONFIRM-R13**：【组件边界】气泡确认是局部非模态确认，默认没有页面遮罩和独立关闭叉。删除、移除不使用本组件；需要阻断页面的确认使用居中确认弹窗。 - **POPCONFIRM-R14**：当前规范示例会恢复账号、状态和备注列的本地显示选择；取消保留选择。存款记录的业务示例恢复列设置草稿，仍需点击保存才应用到表格；两处均不提交后台请求，也不提供请求失败模拟。 ## 场景与验收清单 以下为需核对的场景组；`[ ]` 不代表已经测试通过。 - [ ] **POPCONFIRM-S01**：当前样例：可切换状态和备注列；点击恢复默认打开气泡，确认后显示账号、状态、备注三列，取消保留当前选择。 - [ ] **POPCONFIRM-S02**：接入验收：核对具体对象与动作；确认、取消或按退出键（Esc）主动关闭后回到原入口，点击外部关闭时保留新点击目标的焦点；取消或关闭不触发业务动作。 - [ ] **POPCONFIRM-S03**：业务场景：存款记录 → 列设置 → 恢复默认；先修改列草稿，取消气泡时保留修改，确认时恢复默认，点击保存后才应用到表格。通过本组件的场景链接可直接进入列设置。 - [ ] **POPCONFIRM-S04**：边界验收：本气泡只承载轻量非删除确认；删除和移除仍保留红字入口，但必须打开居中确认弹窗，不为草稿删除另用气泡或跳过确认。 - [ ] **POPCONFIRM-S05**：共用视觉验收：仅核对本组件实际适用的颜色与组合状态；无此能力标为不适用，不给静态内容添加输入错误、半选或按下状态。 - [ ] **POPCONFIRM-S06**：共用文字验收：正文14px/400、次级操作12px/400、标题600；检查实际子元素与弹出层。输入焦点只改自身边框，按钮和链接保留键盘焦点轮廓。 - [ ] **POPCONFIRM-S07**：当前示例：打开后聚焦取消按钮；确认、取消或退出键主动关闭后恢复入口焦点，点击外部关闭时保留新点击目标焦点。入口为操作蓝文字，确认按钮为主按钮，按钮文案统一“确认”。 ### 专题验收重点 当前样例验证恢复默认后列选择实际改变，取消、退出键或外部关闭保留选择；确认、取消或退出键主动关闭后回到入口，外部关闭保留新点击目标焦点。业务场景另核对恢复草稿、取消保留及保存后表格更新。删除、移除入口必须使用居中确认弹窗。 ## 当前示例模板 以下来自本专题的结构化示例，使用 Vue 2 模板语法。`v-model`、事件方法、数据列表等依赖 [components.js](../components.js)；完整样式文件及加载顺序见 [通用基线](FOUNDATIONS.md)。自定义组合标签的内部实现由下方依赖文件提供，不能仅复制标签作为完整组件。 ```html ``` ## 交付与使用边界 - 规范条款、示例代码与待验收场景分开理解；有示例不等于已覆盖所有样式、交互状态和使用场景。 - 业务接口、权限、时区、金额精度、数据规模等依赖应从实际项目读取，不使用演示值代替生产约定。 - 发生样式或文案变更时，同步专题数据、页面与 Markdown，避免规范和样例分离。 ## 来源与关联 - 来源线索：本次补充。 - [打开本专题页面](../index.html#spec-popconfirm) - [通用基线](FOUNDATIONS.md) - [规范总索引](README.md) - [结构化规范数据](../component-data.json)（记录 id：`popconfirm`） - [原始历史样板](../original-20260621.html) - [历史规范条目](../spec-notes.json) 自定义示例 `confirm-popover-pattern` 的实现：[feedback-patterns.js](../feedback-patterns.js)。 ## 本组件颜色状态表 | 状态 / 条件 | 统一规则 | | --- | --- | | 气泡内容 | 白底、正文深灰、边框灰与公共阴影；普通设置说明可使用主题蓝信息图标，不使用删除风险图标。气泡自身不增加页面遮罩。 | | 触发入口 | 轻量非删除操作使用操作蓝、12px/400、无框透明底，并保留键盘焦点；删除和移除的红字入口转到居中确认弹窗。 | | 确认与取消 | 正文说明要执行的具体动作，按钮统一显示“确认”和“取消”；确认使用主按钮，取消使用普通按钮。取消、退出键和外部关闭均不修改设置。 | | 关闭与后续处理 | 本地恢复默认在确认后立即更新设置草稿；业务列设置仍需保存后才作用于表格。确认、取消或按退出键主动关闭后回到触发器，点击外部关闭时保留新点击目标的焦点。 | 气泡确认是局部非模态确认，默认没有页面遮罩和独立关闭叉。删除、移除不使用本组件；需要阻断页面的确认使用居中确认弹窗。 [公共颜色与字体 token](../color-tokens.json) · [公共组件样式](../color-contract.css) · [系统字体合同（最后加载）](../font-contract.css) ## 业务落地场景 - [存款记录 · 列设置 · 恢复默认](../../showcase/index.html?example=popconfirm#deposits) · [场景文档](../../showcase/docs/deposits.md)；落地范围：恢复当前列设置草稿；需点保存才应用到列表。删除不使用气泡确认。 [竞品组件拆解](../../reference-review/竞品组件反推规范.html) · [业务场景分类](../../业务场景分类清单.md)