## addRange('name值', '标题' [, '提示', '默认值', '参数', '额外属性', '额外css类'])
标识符:`range`
| 参数 | 含义 | 类型 |
| --- | --- | --- |
| name | name值 | string |
| title | 标题 | string |
| tips | 提示 | string |
| default | 默认值 | string |
| options | 参数 | array |
| extra_attr | 额外属性 | string |
| extra_class | 额外css类 | string |
~~~
return ZBuilder::make('form')
->addRange('test1', '默认范围(10-100)')
->fetch();
~~~
![](https://box.kancloud.cn/8efca14135cd40d3d45bc09c8c24b70c_1172x94.png)
### 默认值
默认范围是10到100,初始值为10,也可以设置一个初始默认值。
~~~
return ZBuilder::make('form')
->addRange('test1', '默认范围(10-100)', '', 45)
->fetch();
~~~
![](https://box.kancloud.cn/2a31868f07d6ff7b2db70d05ded7433d_1165x86.png)
>[danger] 注意,如果是两个值
### 参数
`addRange`方法支持定义33个不同的参数,包含了[Range Sliders](https://github.com/IonDen/ion.rangeSlider)绝大部分的参数,详细参数可以参考[Range Sliders](https://github.com/IonDen/ion.rangeSlider)官方网站。
下面演示一些常用参数
* **设置最小最大值**
~~~
->addRange('test2', '最小最大值', '', 100, ['min' => 50, 'max' => 999])
~~~
![](https://box.kancloud.cn/3698d4b71e118002aeb989e279fae087_1170x86.png)
* **设置网格**
~~~
->addRange('test3', '网格', '', 50, ['grid' => 'true'])
~~~
![](https://box.kancloud.cn/45b99f447c2d752c9c3a9c5d884c68b7_1173x121.png)
* **设置范围**
如果要设置两个值,需要将参数`double`设为`true`
~~~
->addRange('test4', '两个值', '', '', ['double' => 'true', 'from' => 40, 'to' => 80])
~~~
![](https://box.kancloud.cn/12a9cb2b78ad89ba69526e88ef2f153c_1164x84.png)
其中,`from`和`to`参数是取值范围,也可以写到默认值,两个值之间用`;`隔开。
~~~
->addRange('test4', '两个值', '', '40;80', ['double' => 'true'])
~~~
如果希望两个值之间的分割符为逗号,可以设置`input_values_separator`参数。
~~~
->addRange('test4', '两个值', '', '40,80', ['double' => 'true', 'input_values_separator' => ','])
~~~
这时候,默认值的两个值就要用`,`隔开,而不是用`;`隔开。
* **设置负值**
~~~
->addRange('test5', '设置负值', '', 800, ['min' => -500, 'max' => 999])
~~~
![](https://box.kancloud.cn/75d08d4223cb43288bf1f1823fb0dc44_1164x90.png)
* **设置步进值和显示网格**
~~~
->addRange('test6', '设置步进值', '', 300, ['grid' => 'true', 'min' => 100, 'max' => 900, 'step' => 100])
~~~
![](https://box.kancloud.cn/b676bff7a11222fe743c3164307ebee2_1176x123.png)
以上设置了步进值为100,也就是每移动一次增加或减少100。
* **自定义**
还可以自定义内容,比如定义为月份。
~~~
->addRange('test7', '自定义', '', 5, ['grid' => 'true', 'values' => '一月, 二月, 三月, 四月, 五月, 六月, 七月, 八月, 九月, 十月, 十一月, 十二月'])
~~~
![](https://box.kancloud.cn/2c6fb3c83113459b7da3cb1d92e76d4d_1180x120.png)
其中,默认值5表示数据的第6位,也就是“六月”,它表示下标,数据的下标从0开始。
* **前缀**
~~~
->addRange('test8', '前缀', '', '', ['grid' => 'true', 'min' => 1000, 'max' => 10000, 'from' => 2500, 'prefix' => '$'])
~~~
![](https://box.kancloud.cn/56aa8b5ff2c6cf30e29668a0d2e8b5f3_1175x113.png)
更多的设置方法,请大家参考[Range Sliders](https://github.com/IonDen/ion.rangeSlider)的文档,自由发挥。
- 序言
- 环境搭建
- 下载及安装
- 目录结构
- 快速构建器(ZBuilder)
- 表单(form)
- 设置页面标题
- 设置页提示信息
- 设置表单提交地址
- 隐藏按钮
- 添加按钮
- 设置按钮标题
- 添加表单项
- 复选
- 单选
- 日期
- 时间
- 开关
- 标签
- 数组
- 分组
- 范围
- 按钮
- 数字框
- 密码框
- 取色器
- 下拉菜单
- 普通联动
- 快速联动
- 拖拽排序
- 静态文本
- 格式文本
- 日期时间
- 日期范围
- 图片裁剪
- 百度地图
- 单文件上传
- 多文件上传
- 单图片上传
- 多图片上传
- 隐藏表单项
- 图标选择器
- 单行文本框
- 多行文本框
- 百度编辑器
- CKEditor编辑器
- wang编辑器
- markdown编辑器
- summernote编辑器
- 图片展示(1.1.0+)
- 单文件展示(1.1.0+)
- 多文件展示(1.1.0+)
- 下拉菜单Ajax(1.3.3+)
- 复杂表格(1.4.3+)
- 数据表格(1.4.3+)
- 分组下拉菜单(1.4.3+)
- 表格选取(1.4.3+)
- 穿梭框(1.4.3+)
- 添加表单项通用方法
- 直接设置表单项
- 表单布局
- 设置Tab按钮列表
- 设置表单数据
- 引入js文件
- 引入css文件
- 设置额外JS代码
- 设置额外CSS样式
- 设置额外HTML代码
- 是否ajax方式提交
- 设置模版路径
- 设置触发器
- 设置表单提交确认框
- 自定义表单项(1.0.6+)
- 设置表单提交方式(1.0.6+)
- 模板变量赋值(1.0.7+)
- 设置页面空表单项提示(1.0.7+)
- 自定义扩展表单图标(1.2.0+)
- 设置表单令牌(1.3.1+)
- 新窗口打开返回的url(1.4.4+)
- 表格(table)
- 设置页面标题
- 设置页面提示信息
- 添加一列
- 字段类型
- switch
- status
- yesno
- text.edit
- textarea.edit
- password
- url
- tel
- number
- icon
- byte
- date
- time
- datetime
- date.edit
- time.edit
- datetime.edit
- picture
- pictures
- select
- callback
- link
- text
- img_url
- files(1.1.1+)
- popover(1.4.4+)
- 添加多列
- 添加数量索引
- 添加快捷编辑的验证器
- 设置表格数据
- 隐藏第一列多选框
- 添加表头排序
- 添加表头筛选
- 添加表头筛选条件
- 添加时间段筛选
- 添加一个右侧按钮
- 添加多个右侧按钮
- 添加一个顶部按钮
- 添加多个顶部按钮
- 自动添加按钮
- 自动编辑按钮
- 替换右侧按钮
- 设置搜索参数
- 设置数据库表名
- 设置插件名称
- 设置表格主键
- 设置Tab按钮列表
- 设置分页
- 去除分页
- 引入js文件
- 引入css文件
- 设置额外JS代码
- 设置额外CSS样式
- 设置额外HTML代码
- 设置额外HTML代码-模板文件(1.4.0+)
- 设置模版路径
- 添加行class名
- 添加顶部下拉筛选
- 设置页面空数据提示(1.0.7+)
- 模板变量赋值(1.0.7+)
- 设置使用原始数据字段(1.0.8+)
- 设置搜索区域(1.1.0+)
- 设置表格高度(1.3.0+)
- 固定左列(1.3.0+)
- 固定右列(1.3.0+)
- 设置列宽(1.3.0+)
- 设置隐藏列(1.3.0+)
- 侧栏(aside)
- 添加区块
- 设置Tab按钮列表
- 追加Tab按钮列表
- 设置当前tab
- 设置单个tab内容
- 设置多个tab内容
- 追加tab内容
- 覆盖侧栏
- 模块开发
- 创建模块信息文件
- 安装模块
- 模块配置
- 控制器
- 创建菜单节点
- 第一个控制器
- 模块参数配置页面
- 方法参考
- 数据授权(1.3.2+)
- 插件开发
- 插件入口文件
- 插件基本信息
- 管理界面的字段信息
- 新增或编辑的字段信息
- 插件钩子
- 触发器
- 原数据库表前缀
- 插件配置信息
- 安装和卸载Sql文件
- 控制器
- 模型
- 验证器
- 视图
- 方法参考
- 实践教程
- 变量参考
- 函数参考
- 安全相关
- 常见问题
- 其他杂项
- 更新日志
- 升级指导
- 贡献名单
- 关于文档