yii2-widget-rangeinput

The RangeInput widget is a customized range slider control widget based on HTML5 range input. The widget enhances the default HTML range input with various features including the following:

• Specially styled for Bootstrap 3.0 with customizable caption showing the output of the control.
• Ability to prepend and append addons (very useful to show the min and max ranges, and the slider measurement unit).
• Allow the input to be changed both via the control or the text box.
• Automatically degrade to normal text input for unsupported Internet Explorer versions.

NOTE: This extension is a sub repo split of yii2-widgets. The split has been done since 08-Nov-2014 to allow developers to install this specific widget in isolation if needed. One can also use the extension the previous way with the whole suite of yii2-widgets.

Installation

The preferred way to install this extension is through composer. Check the composer.json for this extension's requirements and dependencies. Read this web tip /wiki on setting the minimum-stability settings for your application's composer.json.

To install, either run

$ php composer.phar require kartik-v/yii2-widget-rangeinput "*"

or add

"kartik-v/yii2-widget-rangeinput": "*"

to the require section of your composer.json file.

Latest Release

NOTE: The latest version of the module is v1.0.1 released on 22-Nov-2015. Refer the CHANGE LOG for details.

Demo

You can refer detailed documentation and demos on usage of the extension.

Usage

use kartik\range\RangeInput;

// Usage with ActiveForm and model
echo $form->field($model, 'rating')->widget(RangeInput::classname(), [
    'options' => ['placeholder' => 'Select range ...'],
    'html5Options' => ['min'=>0, 'max'=>1, 'step'=>1],
    'addon' => ['append'=>['content'=>'star']]
]);

// With model & without ActiveForm
echo '<label class="control-label">Adjust Contrast</label>';
echo RangeInput::widget([
    'model' => $model,
    'attribute' => 'contrast',
    'addon' => ['append'=>['content'=>'%']]
]);

License

yii2-widget-rangeinput is released under the BSD 3-Clause License. See the bundled LICENSE.md for details.