低代码平台核心组件表单设计器 unione-form-editor 组件属性介绍--滑块输入组件
在企业级低代码表单开发中,滑块输入组件是兼顾"直观交互、精准控值、视觉友好"的特色组件,相较于传统文本、数值输入框,它通过拖拽游标即可快速完成数值选择,实时呈现调节反馈,广泛应用于音量调节、评分设置、参数配置、区间筛选等场景。unione-form-editor 滑块输入组件,依托丰富的专属配置,支持连续/离散滑动、单/双游标范围选择、自定义刻度与样式,无需编码即可适配从简单数值调节到复杂区间控制的全场景,彻底解决精准控值繁琐、交互体验生硬的痛点,下面详细拆解其核心属性与专属能力。

一、组件属性Tab页:滑块交互全场景适配,精准控值无压力
组件属性Tab页延续同系列组件的"基础属性+表单验证+功能属性+事件设置"四大模块,重点结合滑块组件的拖拽交互、数值调节特性,新增滑动模式、步长、刻度等专属配置项,既保持操作一致性,又精准匹配滑块场景的特殊需求,兼顾易用性与专业性,新手也能快速上手配置。
1. 基础属性:定义组件核心标识与基础信息
与同系列组件基础配置保持一致,同时结合滑块场景优化提示与标识,明确组件调节用途,降低用户操作疑问:
-
控件名称:组件的显示名称,用于设计界面快速识别,如"滑块输入""参数调节滑块""评分滑块""区间选择滑块";
-
字段名称:数据存储的唯一标识,需遵循大写字母、数字和下划线组成的规则,且不能是数据库关键字,示例中可配置为"SLIDER_VALUE""PARAMETER""SCORE""PRICE_RANGE"等,用于关联后端数值或区间类型字段;
-
字段标题:表单中向用户展示的标签文本,如"音量调节""满意度评分""价格区间""参数阈值",明确告知用户滑块调节的数值含义;
-
默认值:支持设置滑块初始游标位置对应的数值,可设置单一默认值(单游标)或区间默认值(双游标),如评分默认3分、音量默认50、价格区间默认50-100,减少用户调节操作;
-
输入提示:滑块组件的辅助提示文本,引导用户操作,如"拖拽游标调节数值""双游标可选择数值区间""评分1-5分,越高越好";
-
控件提示/帮助信息:额外的说明文字,可用于补充滑块调节规则、数值范围、步长要求等,如"数值范围0-100,步长为5,支持精准调节""拖拽游标至目标位置,实时显示当前数值",降低用户操作疑问。
2. 表单验证:数值调节合规性强保障
针对滑块组件的数值调节特性,提供精准的合规性校验能力,确保调节的数值或区间符合业务规范,避免无效数值录入,保障数据准确性:
-
是否必填:开启后用户必须调节滑块(不能停留在默认值或初始位置),否则表单无法提交,适用于评分、参数配置等核心必填场景;
-
数值范围校验:专属核心配置,支持设置滑块调节的最小值和最大值,如0-100(音量)、1-5(评分)、0-1000(价格),游标无法超出设定范围,从源头避免无效数值;
-
步长校验:校验用户调节的数值是否符合预设步长,如步长为5时,仅允许调节0、5、10...等整数,避免非标准数值录入,适配需要标准化参数的场景;
3. 功能属性:滑块专属交互与配置优化
作为滑块组件的核心亮点,功能属性模块新增大量滑块专属配置,兼顾交互便捷性、控值精准度与视觉反馈,覆盖绝大多数企业级滑块调节场景,贴合滑块组件的核心构成与交互逻辑:
-
滑动模式设置:支持四种核心模式,适配不同场景需求------连续滑块(游标自由滑动,可选择任意范围内数值,如音量调节)、离散滑块(游标自动卡点到预设刻度,仅可选固定数值,如评分)、居中滑块(初始值在轨道中间,可双向调节正负数值,如色彩冷暖调整)、范围滑块(双游标,可选择数值区间,如价格筛选),一键切换适配场景;
-
数值范围配置:自定义设置滑块的最小值和最大值,支持正负数值(如-50至50),适配需要双向调节的场景,同时可设置数值显示格式(如整数、保留1-2位小数);
-
步长控制:设置滑块调节的步长(如1、5、0.1),离散滑块需配合步长使用,连续滑块可通过步长限制精准度,避免误触导致的数值偏差,步长设置需在0.01至最大值与最小值差值范围内;
-
刻度与标签设置:支持显示滑块刻度(如每隔10显示一个刻度),可设置刻度显示密度(避免过多刻度导致界面杂乱),同时可给刻度添加标签(如评分1-5分对应"很差""一般""优秀"),提升用户理解度,游标可自动吸附到最近刻度值;
-
游标配置:支持设置游标样式(圆形、方形)、大小、颜色,区分已调节轨道与未调节轨道的颜色,提升视觉辨识度;双游标模式下,可分别设置两个游标的样式,便于区分最小值与最大值游标;
-
实时反馈设置:支持开启游标拖动时的实时数值提示(如拖动时显示当前数值),调节完成后可保留数值显示,让用户清晰了解当前调节结果,同时可设置数值提示的显示位置(游标上方、滑块右侧);
-
滑动方向设置:支持水平滑动(默认)和垂直滑动,垂直滑动适用于音量调节、高度参数等场景,可根据表单布局灵活选择,同时可设置取值范围是否反向(如横向滑块从右往左数值递增);
-
是否只读/禁用/隐藏:灵活控制组件的交互状态,如预览模式下,滑块仅显示当前数值、不可拖动;审批流程中,参数滑块禁用,仅可查看;
-
显示标题:控制字段标题是否在表单中显示,适配紧凑布局或无标题表单设计;
4. 事件设置:滑块联动与动态交互逻辑
继承同系列组件的事件能力,针对滑块的拖拽交互特性优化联动逻辑,实现表单的动态响应,满足复杂业务中的滑块联动需求,贴合滑块组件的交互反馈特性:
-
变化事件:滑块数值发生变化(拖动、重置、联动修改)时触发,可用于更新表单相关数据(如显示当前数值、校验数值合规性);
-
动态标题:根据业务逻辑动态修改字段标题,如根据表单类型,将标题切换为"音量调节""亮度参数""满意度评分";
-
禁用/显示/必填事件:通过条件判断控制组件的禁用、显示/隐藏、必填状态,如当表单类型为"预览"时,滑块禁用;当选择"需要评分"时,滑块必填;
-
所有事件均支持代码编辑,可自定义业务逻辑,也可开启"显示代码"查看事件配置详情,灵活适配复杂滑块联动场景(如跨组件参数联动、动态调整滑块范围)。
二、组件样式Tab页:多端适配与界面美化
与同系列组件保持一致的样式配置体系,同时适配滑块组件的界面特性(如轨道、游标、刻度、数值提示),结合滑块个性化设计要点,确保表单整体风格统一,兼顾实用性与美观度:
-
多端显示:支持单独配置组件在PC端、移动端是否显示,滑块轨道、游标在移动端自动适配屏幕宽度,优化触摸拖拽体验,避免游标过小难以操作,同时适配移动端垂直滑动场景;
-
栅格显示:基于24栅格系统,可调节组件在表单中的宽度占比(范围2-24),灵活适配不同布局,如水平滑块可设置为占比20,垂直滑块可设置为占比4,适配表单整体排版;
-
标题宽度/控件宽度:自定义字段标题和滑块轨道的宽度,适配表单整体排版,避免标题过长或轨道过宽/过窄影响操作与美观;
-
Class名称:支持自定义CSS类名,可通过外部样式文件对组件进行深度美化,如修改轨道颜色、游标样式、刻度大小、数值提示字体,适配企业品牌化设计需求,打造与产品风格统一的滑块外观;
-
轨道与刻度样式:支持设置轨道厚度、圆角、已调节/未调节轨道的颜色渐变,设置刻度的颜色、大小,优化视觉层次,让滑块界面更美观、更易识别,同时可控制刻度显示密度,避免界面杂乱。
结语
unione-form-editor 滑块输入组件,以"直观交互、精准控值、灵活适配"为核心,既延续了同系列组件的易用性与扩展性,又针对滑块的拖拽交互特性,新增了滑动模式、步长控制、刻度标签、实时反馈等专属功能,无需编写复杂代码,即可快速搭建从简单数值调节到复杂区间筛选的各类场景。无论是音量调节、评分设置,还是参数配置、价格筛选,都能轻松应对,有效提升表单交互体验与数值录入的精准度,贴合各类滑块应用场景的核心需求。
作为低代码平台的核心组件,unione-form-editor 始终以"高效、灵活、易用"为核心,除了完善的滑块输入组件,还提供丰富的表单组件、可视化拖拽设计、复杂交互配置等能力,助力开发者快速搭建企业级表单。
目前项目已在GitHub、Gitee开源,欢迎前往点亮Star,获取完整源码、查看详细教程,参与社区共建,一起打造更强大的低代码表单设计工具!
GitHub项目地址 :https://github.com/unione-cloud/unione-form-editor
Gitee项目地址 :https://gitee.com/unione-cloud/unione-form-editor