kartik-v/yii2-widget-rangeinput An enhanced Yii 2 widget encapsulating the HTML 5 range input (sub repo split from yii2-widgets)

extensionwidgetjqueryrangepluginforminputhtml5

Krajee Logo
yii2-widget-rangeinput Donate

Stable Version Unstable Version License Total Downloads Monthly Downloads Daily Downloads

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.x and Bootstrap 4.x 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.

Release Changes

Refer the CHANGE LOG for details on various releases and changes.

Demo

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

Usage

use kartik\range\RangeInput;

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

]);

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

// Vertical orientation
echo '<label class="control-label">Adjust Contrast</label>';
echo RangeInput::widget([
    'name' => 'slider',
    'value' => 70,
    'orientation' => 'vertical',
    'html5Container' => ['style' => 'width:350px'],
]);

License

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

Changelog

Change Log: yii2-widget-rangeinput

Version 1.0.2

Date: 07-Sep-2018

  • Add github contribution and issue/PR log templates.
  • Update to include Bootstrap 4.x support
  • Reorganize source code into src directory

Version 1.0.1

Date: 22-Nov-2015

  • Update HTML5 input initialization

Version 1.0.0

Date: 08-Nov-2014

Statistics

Downloads
GitHub Stars
GitHub Forks

Releases

Comments



v1.0.2 is the latest of 3 releases



BSD-3-Clause license
Stats
19 github stars & 0 github forks
564 downloads in the last day
42105 downloads in the last 30 days
3079203 total downloads