--- id: "slider" title: "滑块" category: "选择组件" document_type: "component-specification" spec_status: "local-current-draft" element_ui: "2.15.6" vue: "2.6.14" page: "../index.html#spec-slider" source_data: "../component-data.json" official_components: ["slider"] template_components: ["el-slider"] scenario_count: 7 verification: "scenario-checklist-not-full-test-pass" --- # 滑块 专题 `slider` · 选择组件 · Element UI 2.15.6 ## 适用范围与组件映射 公共色板及字体基线适用于整个运营后台。本库整理基础组件、组件状态和可复用的组合模式；本轮补齐表单整体验证、页面布局和导航组合；具体业务字段与跨页流程仍在业务场景中说明。专题验收清单包含接入要求，不表示当前示例已实现或已验证全部场景。 官方条目映射：`slider`。 本页模板直接使用的 Element UI 标签：`el-slider`。 ## 通用基线 - 组件库：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`；保留点击热区。 - 本规范库的深色目录、蓝色展示区属于文档排版，不是业务组件颜色或业务导航规范。 ## 本页用法与分类 默认用法：选择一个小范围数值时，默认使用当前单值滑块，并保留同步的数字输入；只有字段本身是起止区间时才用双手柄范围滑块。 | 区分什么 | 本页内容 | 选用或触发条件 | | --- | --- | --- | | 功能：单值或范围 | 单手柄返回一个数值，双手柄返回区间两端。 | 按字段是单值还是区间选择；双手柄不是更醒目的样式，也不是完成进度。 | | 功能：精度与输入方式 | 上下限、步长、单位和数字输入决定怎样修改数值。 | 当前单值示例提供数字输入，范围示例仅双手柄。需要精确编辑时明确补充输入方式；资金精确录入使用数字输入规范。 | | 布局：方向与刻度 | 纵向、刻度和停靠点帮助匹配空间与可枚举值。 | 当前默认横向。确有纵向空间或离散值需求才另行配置并验收，不能靠缩小控件和文字解决空间不足。 | | 自动状态：拖动与禁用 | 焦点、拖动和到达边界由操作产生；禁用来自不可修改条件。 | 禁用时阻止拖动和键盘改值并保留可读数值；错误只在真实字段约束失败时提示。 | 使用边界：不把单值、带输入、双手柄和禁用列成互斥的几种样式。不把滑块着色用于成功或失败进度。 ## 组件规则 - **SLIDER-R01**：适合连续或可枚举的小范围数值选择；要求精确输入时同时提供数字输入，不用于精确资金录入。 - **SLIDER-R02**：先按字段确定单值或起止范围，再确定最小值、最大值、步长与单位；数字输入属于精确编辑功能。禁用由业务是否允许修改决定，不作为可选样式。 - **SLIDER-R03**：键盘可按步长调整，范围两端不得交叉；最小 / 最大值有可读标签。 - **SLIDER-R04**：【公共用色】颜色仅从公共色值 引用：主色系 3 个基础色值、辅助功能色 3 个、中性色 10 个，共 16 个基础色值。角色可以多个，实际色值复用；不为每个组件、悬停 或不同字段再新增近似颜色。透明效果仅限遮罩 35% 与阴影 12%，从 外壳深色 派生。 - **SLIDER-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；不通过额外加粗或透明度改变正文轻重。 - **SLIDER-R06**：【叠加优先级】状态叠加规则：禁用阻断交互；输入类控件错误边框覆盖蓝色聚焦边框；输入框不叠加外圈或阴影，其他无边框操作保留键盘焦点提示；选中底覆盖悬停底；只读不等于禁用；加载不等于成功；业务启用/停用的文字结果不等于控件是否可点击。 - **SLIDER-R07**：滑块拖动和键盘定位不触发表单红框。宿主约束校验失败时，就近显示错误红短提示；只有附属数字输入本身的值非法时才同步该输入框边框。未使用数字输入的范围滑块不凭空添加错误外框或图标。 - **SLIDER-R08**：【数值与轨道】未选轨道分隔灰、已选范围主题蓝；手柄白底主题蓝边，数值正文深灰。 - **SLIDER-R09**：【拖动与键盘】拖动保留主题蓝；键盘焦点操作蓝轮廓，数值提示同步当前值，不用按钮按下位移规则。 - **SLIDER-R10**：【禁用】禁用轨道浅灰背景、手柄边框灰，并阻止拖动和键盘调值；已有数值保持可读。 - **SLIDER-R11**：【范围与校验】双手柄只表示起止数值，不存在复选半选；真实表单约束失败时就近错误红提示，不把整个轨道当失败进度。 - **SLIDER-R12**：【组件边界】滑块表达数值选择，不是任务进度；没有“完成成功绿”或“异常红色进度”状态，也不包含骨架屏。 ## 场景与验收清单 以下为需核对的场景组；`[ ]` 不代表已经测试通过。 - [ ] **SLIDER-S01**：当前样例：0–100单值滑块与数值输入同步、双端范围滑块。 - [ ] **SLIDER-S02**：接入验收：按数值规则检查步长、上下限和单位；需要离散值或纵向空间时再配置停靠点、刻度或纵向布局；禁用与键盘调整按实际可用条件验证。 - [ ] **SLIDER-S03**：区分滑动中的 input 与结束后的 change 事件；拖动不应连续触发业务提交。 - [ ] **SLIDER-S04**：若附加表单约束再检查错误说明；滑块自身不是带成功/失败状态的进度条。 - [ ] **SLIDER-S05**：共用视觉验收：仅核对本组件实际适用的颜色与组合状态；无此能力标为不适用，不给静态内容添加输入错误、半选或按下状态。 - [ ] **SLIDER-S06**：共用文字验收：正文14px/400、次级操作12px/400、标题600；检查实际子元素与弹出层。输入焦点只改自身边框，按钮和链接保留键盘焦点轮廓。 - [ ] **SLIDER-S07**：Tab只停靠每个真实手柄一次；范围手柄分别朗读起点/终点与当前值，方向键调整不突破上下界。 ### 专题验收重点 键盘步进、边界、双端范围、输入与拖拽值同步。 ## 当前示例模板 以下来自本专题的结构化示例，使用 Vue 2 模板语法。`v-model`、事件方法、数据列表等依赖 [components.js](../components.js)；完整样式文件及加载顺序见 [通用基线](FOUNDATIONS.md)。自定义组合标签的内部实现由下方依赖文件提供，不能仅复制标签作为完整组件。 ### 本示例的运行依赖 - 下方只展示专题内部模板，不包含外层宿主。当前适配要求将它置于唯一的 `
` 中；只复制内部标签不会自动获得这里规定的键盘与语义行为。 - 使用 Vue **2.6.14**、Element UI **2.15.6**，接入 [components.js](../components.js) 中本例所需的数据和方法，并按 [通用基线](FOUNDATIONS.md) 加载公共样式。 - 键盘与读屏语义依赖 [choice-semantics.js](../choice-semantics.js)，可见焦点依赖 [global-component-contract.css](../global-component-contract.css)。共享字段名称另由 [form-semantics.js](../form-semantics.js) 补充。适配安装前必须存在上述专题宿主及已挂载组件。 - 保留`spec-slider-single-label`、`spec-slider-range-label`，用于关联可见名称。适配消除外围重复 Tab 停靠，给真实手柄分别命名，并关联单值示例的数字输入；范围起点、终点分别读取实际值。 - 此脚本读取 Vue 的 `__vue__`、实例引用和内部状态，绑定上述精确版本及固定 `spec-*` 作用域；这些不是公共 API。升级、多个实例或业务路由接入时，应改为组件生命周期内的实例引用方案，重新分配唯一标签 ID，并重新验证，不能仅复制脚本或更改外层 ID。 - 本片段及文档不是独立运行包。实际接入还需核对名称、键盘、边界、动态挂载与销毁；本地逻辑检查不代替浏览器及读屏验收。 ```html

单值选择（带数字输入，0–100）

范围选择（双手柄，0–100）

两组最小值0、最大值100，步长1；双手柄分别表示区间起点和终点。

``` ## 交付与使用边界 - 规范条款、示例代码与待验收场景分开理解；有示例不等于已覆盖所有样式、交互状态和使用场景。 - 业务接口、权限、时区、金额精度、数据规模等依赖应从实际项目读取，不使用演示值代替生产约定。 - 发生样式或文案变更时，同步专题数据、页面与 Markdown，避免规范和样例分离。 ## 来源与关联 - 来源线索：本次补充。 - [打开本专题页面](../index.html#spec-slider) - [通用基线](FOUNDATIONS.md) - [规范总索引](README.md) - [结构化规范数据](../component-data.json)（记录 id：`slider`） - [原始历史样板](../original-20260621.html) - [历史规范条目](../spec-notes.json) ## 本组件颜色状态表 | 状态 / 条件 | 统一规则 | | --- | --- | | 数值与轨道 | 未选轨道分隔灰、已选范围主题蓝；手柄白底主题蓝边，数值正文深灰。 | | 拖动与键盘 | 拖动保留主题蓝；键盘焦点操作蓝轮廓，数值提示同步当前值，不用按钮按下位移规则。 | | 禁用 | 禁用轨道浅灰背景、手柄边框灰，并阻止拖动和键盘调值；已有数值保持可读。 | | 范围与校验 | 双手柄只表示起止数值，不存在复选半选；真实表单约束失败时就近错误红提示，不把整个轨道当失败进度。 | 滑块表达数值选择，不是任务进度；没有“完成成功绿”或“异常红色进度”状态，也不包含骨架屏。 [公共颜色与字体 token](../color-tokens.json) · [公共组件样式](../color-contract.css) · [系统字体合同（最后加载）](../font-contract.css) ## 业务落地场景 - [运营总览 · 趋势图 · 区间选择滑块](../../showcase/index.html#overview) · [场景文档](../../showcase/docs/overview.md) [竞品组件拆解](../../reference-review/竞品组件反推规范.html) · [业务场景分类](../../业务场景分类清单.md)