牛骨文教育服务平台(让学习变的简单)

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])

其中,fromto参数是取值范围,也可以写到默认值,两个值之间用;隔开。

->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的文档,自由发挥。