kartik-v/yii2-slider

An advanced slider input for Yii Framework 2 for both touch enabled and desktop devices based on bootstrap-slider.

Installs: 653 337

Dependents: 11

Suggesters: 0

Security: 0

Stars: 28

Watchers: 6

Forks: 20

Open Issues: 11

Type:yii2-extension

v1.3.2 2016-01-10 17:24 UTC

This package is auto-updated.

Last update: 2024-12-05 04:35:10 UTC


README

Krajee Logo
yii2-slider Donate

Stable Version Unstable Version License Total Downloads Monthly Downloads Daily Downloads

An advanced slider input for Yii Framework 2 based on seiyria/bootstrap-slider plugin, which is a fork of the bootstrap-slider by Stefan Petre from eyecon.ru. The slider input offers these advanced features

  • vertical or horizontal orientation of slider
  • setup your minimum and maximum values
  • setup your step increments
  • range selector (multiple handles to control the range)
  • three shapes for handles
  • touch capablity and support for touch devices

Additional enhancements added for this widget (by Krajee):

  • allows to configure slider selection and handle colors.
  • preselected styles to color your slider and handles.
  • automatically trigger change of base field on slider stop to enforce Yii ActiveField validation
  • automatically set plugin options based on base field value (parse array input value for range)
  • automatically disable slider based on disabled/readonly options.

Demo

You can see detailed documentation on usage of the extension.

Latest Release

Refer the CHANGE LOG for details on updates to various releases.

Installation

The preferred way to install this extension is through composer.

NOTE: 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.

Either run

$ php composer.phar require kartik-v/yii2-slider "dev-master"

or add

"kartik-v/yii2-slider": "dev-master"

to the require section of your composer.json file.

Usage

Slider

use kartik\slider\Slider;
echo Slider::widget([
    'name' => 'slider',
    'sliderColor' => Slider::TYPE_DANGER,
    'handleColor' => Slider::TYPE_DANGER,
    'pluginOptions' => [
        'orientation' => 'horizontal',
        'handle' => 'round',
        'min' => 0,
        'max' => 255,
        'step' => 1
    ],
]); 

License

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