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();
默认值
默认范围是10到100,初始值为10,也可以设置一个初始默认值。
return ZBuilder::make("form")
->addRange("test1", "默认范围(10-100)", "", 45)
->fetch();
注意,如果是两个值
参数
addRange
方法支持定义33个不同的参数,包含了Range Sliders绝大部分的参数,详细参数可以参考Range Sliders官方网站。
下面演示一些常用参数
- 设置最小最大值
->addRange("test2", "最小最大值", "", 100, ["min" => 50, "max" => 999])
- 设置网格
->addRange("test3", "网格", "", 50, ["grid" => "true"])
- 设置范围
如果要设置两个值,需要将参数double
设为true
->addRange("test4", "两个值", "", "", ["double" => "true", "from" => 40, "to" => 80])
其中,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])
- 设置步进值和显示网格
->addRange("test6", "设置步进值", "", 300, ["grid" => "true", "min" => 100, "max" => 900, "step" => 100])
以上设置了步进值为100,也就是每移动一次增加或减少100。
- 自定义
还可以自定义内容,比如定义为月份。
->addRange("test7", "自定义", "", 5, ["grid" => "true", "values" => "一月, 二月, 三月, 四月, 五月, 六月, 七月, 八月, 九月, 十月, 十一月, 十二月"])
其中,默认值5表示数据的第6位,也就是“六月”,它表示下标,数据的下标从0开始。
- 前缀
->addRange("test8", "前缀", "", "", ["grid" => "true", "min" => 1000, "max" => 10000, "from" => 2500, "prefix" => "$"])
更多的设置方法,请大家参考Range Sliders的文档,自由发挥。