--- id: "responsive" title: "缩放、窄容器与内容极值" category: "可用性" document_type: "component-specification" spec_status: "local-current-draft" element_ui: "2.15.6" vue: "2.6.14" page: "../index.html#spec-responsive" source_data: "../component-data.json" official_components: [] template_components: [] scenario_count: 7 verification: "scenario-checklist-not-full-test-pass" --- # 缩放、窄容器与内容极值 专题 `responsive` · 可用性 · Element UI 2.15.6 ## 适用范围与组件映射 公共色板及字体基线适用于整个运营后台。本库整理基础组件、组件状态和可复用的组合模式；本轮补齐表单整体验证、页面布局和导航组合；具体业务字段与跨页流程仍在业务场景中说明。专题验收清单包含接入要求，不表示当前示例已实现或已验证全部场景。 本专题为基础规则、同一组件的补充场景或组合模式，不作为独立的 Element UI 官方组件声明。 ## 通用基线 - 组件库：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`；保留点击热区。 - 本规范库的深色目录、蓝色展示区属于文档排版，不是业务组件颜色或业务导航规范。 ## 本页用法与分类 默认用法：默认使用同一套文字、颜色和组件规则，按容器可用空间换行或内部滚动；本页只提供长文本测试内容。 | 区分什么 | 本页内容 | 选用或触发条件 | | --- | --- | --- | | 环境条件 | 窗口宽度、短屏、浏览器缩放和字体放大是使用环境。 | 分别在规定视口和缩放条件下验收，不把这些条件命名成用户可选样式。 | | 内容极值 | 空值、长文本、大数值和长错误信息决定布局压力。 | 按真实内容选择换行、完整值入口或允许的表内滚动，不能用缩小正文解决溢出。 | | 状态保持 | 布局变化不改变当前选中、错误或禁用含义。 | 调整容器宽度后继续保持原状态、可见焦点和可达操作，不生成窄屏专属配色。 | 使用边界：不把1440/768/390px和200%缩放当成四种样式；本页静态文字示例也不能代表全部响应式交互已通过。 ## 组件规则 - **RESPONSIVE-R01**：以组件容器宽度决定换行；在 200% 浏览器缩放下仍可读取和操作。不用 vw 缩字或 transform 缩放整个组件。 - **RESPONSIVE-R02**：输入族的宽度数值与口径以输入框专题为准：按字段整项换行，再在容器内收缩，必要时标签置顶或范围两端分行；同一状态不因空间变化改变字体、颜色、圆角或数据。 - **RESPONSIVE-R03**：覆盖空值、单字、长中英文、超大数值、长文件名、错误多行；有意横向滚动仅限数据表格。 - **RESPONSIVE-R04**：用户字体放大不裁切；弹窗页脚和关闭入口始终可达。动效不作为理解状态的必要条件。 - **RESPONSIVE-R05**：【公共用色】颜色仅从公共色值 引用：主色系 3 个基础色值、辅助功能色 3 个、中性色 10 个，共 16 个基础色值。角色可以多个，实际色值复用；不为每个组件、悬停 或不同字段再新增近似颜色。透明效果仅限遮罩 35% 与阴影 12%，从 外壳深色 派生。 - **RESPONSIVE-R06**：【统一字体】统一系统中文字体：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；不通过额外加粗或透明度改变正文轻重。 - **RESPONSIVE-R07**：【叠加优先级】状态叠加规则：禁用阻断交互；输入类控件错误边框覆盖蓝色聚焦边框；输入框不叠加外圈或阴影，其他无边框操作保留键盘焦点提示；选中底覆盖悬停底；只读不等于禁用；加载不等于成功；业务启用/停用的文字结果不等于控件是否可点击。 - **RESPONSIVE-R08**：【不同视口】正文深灰、操作蓝与功能色保持一致，窄屏不把正文改成浅灰或新增配色。 - **RESPONSIVE-R09**：【换行与截断】长文本继续使用原文字角色；必要说明辅助深灰，查看完整值入口操作蓝。 - **RESPONSIVE-R10**：【状态保持】布局重排后控件保留原选中、错误和禁用语义；聚焦边界按对应组件，不给容器加选中色。 - **RESPONSIVE-R11**：【组件边界】宽度、缩放和文字极值不是交互状态；只改变布局，不生成移动端专属颜色或缩小有效正文。 - **RESPONSIVE-R12**：【保持真实字号】由页面布局处理窄容器、横向滚动和标注位置；不得对整个业务内容应用缩小变换以塞进屏幕。用户主动使用浏览器缩放不属于页面另设字体规格。 ## 场景与验收清单 以下为需核对的场景组；`[ ]` 不代表已经测试通过。 - [ ] **RESPONSIVE-S01**：当前样例仅提供长中英文与连续编号的换行内容；不代表所有组件已通过窄屏与缩放验收。 - [ ] **RESPONSIVE-S02**：接入验收：按网页布局宽度 1440、768、390 像素（不是截图物理像素）检查；同时检查 200%浏览器缩放、操作系统字体放大和短屏。 - [ ] **RESPONSIVE-S03**：接入验收：表内横向滚动、弹窗内部滚动、长错误提示、极值与减少动态效果；无页面级横向溢出。 - [ ] **RESPONSIVE-S04**：共用视觉验收：仅核对本组件实际适用的颜色与组合状态；无此能力标为不适用，不给静态内容添加输入错误、半选或按下状态。 - [ ] **RESPONSIVE-S05**：共用文字验收：正文14px/400、次级操作12px/400、标题600；检查实际子元素与弹出层。输入焦点只改自身边框，按钮和链接保留键盘焦点轮廓。 - [ ] **RESPONSIVE-S06**：宽度联动验收：按输入框专题核对整项与边框口径、同组对齐、长内容、窄容器换行及状态不跳宽。 - [ ] **RESPONSIVE-S07**：标注开关前后，正文保持14px/400、次级操作12px/400；不缩小业务画布，超宽表格按容器横向滚动。 ### 专题验收重点 按1440、768、390 CSS像素及200%浏览器缩放分别验收，确保无页面级横向溢出；当前长文本样例不等于全组件响应式已通过。 ## 当前示例模板 以下来自本专题的结构化示例，使用 Vue 2 模板语法。`v-model`、事件方法、数据列表等依赖 [components.js](../components.js)；完整样式文件及加载顺序见 [通用基线](FOUNDATIONS.md)。自定义组合标签的内部实现由下方依赖文件提供，不能仅复制标签作为完整组件。 ```html
长内容测试：A-very-long-identifier-without-normal-spaces-01234567890123456789，以及中文多行组件说明。
``` ## 交付与使用边界 - 规范条款、示例代码与待验收场景分开理解；有示例不等于已覆盖所有样式、交互状态和使用场景。 - 业务接口、权限、时区、金额精度、数据规模等依赖应从实际项目读取，不使用演示值代替生产约定。 - 发生样式或文案变更时，同步专题数据、页面与 Markdown，避免规范和样例分离。 ## 来源与关联 - 来源线索：本次补充。 - [打开本专题页面](../index.html#spec-responsive) - [通用基线](FOUNDATIONS.md) - [规范总索引](README.md) - [结构化规范数据](../component-data.json)（记录 id：`responsive`） - [原始历史样板](../original-20260621.html) - [历史规范条目](../spec-notes.json) ## 本组件颜色状态表 | 状态 / 条件 | 统一规则 | | --- | --- | | 不同视口 | 正文深灰、操作蓝与功能色保持一致，窄屏不把正文改成浅灰或新增配色。 | | 换行与截断 | 长文本继续使用原文字角色；必要说明辅助深灰，查看完整值入口操作蓝。 | | 状态保持 | 布局重排后控件保留原选中、错误和禁用语义；聚焦边界按对应组件，不给容器加选中色。 | 宽度、缩放和文字极值不是交互状态；只改变布局，不生成移动端专属颜色或缩小有效正文。 [公共颜色与字体 token](../color-tokens.json) · [公共组件样式](../color-contract.css) · [系统字体合同（最后加载）](../font-contract.css) ## 业务落地场景 - [会员列表 · 会员宽表、详情与标注面板的实际可用宽度](../../showcase/index.html#members) · [场景文档](../../showcase/docs/members.md) [竞品组件拆解](../../reference-review/竞品组件反推规范.html) · [业务场景分类](../../业务场景分类清单.md)