1. Features
2. Demo
3. Installation
4. Usage
5. Report
6. License
7. Resources

An extended checkbox widget for Yii Framework 2 based on the bootstrap-checkbox-x jQuery plugin by Krajee. This widget allows three checkbox states and includes additional styles. The plugin uses Bootstrap markup, glyphs, and CSS 3 styling by default, but it can be overridden with any other markup.

Note: The checkbox plugin stores the values as integer format (and not boolean format) for checked and unchecked states.

Features ¶

• The plugin offers the following three states and values for the checkboxes:
  • 1: Checkbox is checked.
  • 0: Checkbox is unchecked.
  • null: Checkbox is indeterminate.
• You can set the plugin to allow three states or the default two states for the checkbox.
• Specifically uses Bootstrap 3.x styles & glyphs. One can configure the checked, unchecked, and indeterminate icons to be shown for the checkboxes.
• Special CSS 3 styling, to enhance the control to look like any Bootstrap 3 form control. Supports the has-error, has-success, has-warning styling states like other Bootstrap form-controls.
• Plugin CSS styling automatically defaults the checkboxes to inline display. You can also control the markup for block display like in checkbox lists.
• You can add a label before or after with a for attribute and click on the label to change the checkbox values. Alternatively you can enclose the input within a label tag as well.
• Ability to navigate to the checkbox controls via keyboard, and modify the values using the space bar on the keyboard.
• Ability to size the checkbox control. Five prebuilt size templates are available xl, lg, md, sm, and xs.
• Triggers JQuery events for advanced development. The plugin automatically triggers the change event for the input, whenever the checkbox value is changed via clicking. Events currently available are change and reset.
• Ability to access methods and refresh the input dynamically via javascript at runtime.
• Disabled and readonly checkbox input support.
• Size of the entire plugin (JS and CSS) is less than 2KB when minified and gzipped. Its about 6KB when minified without gzipping (about 3KB for the JS and 3KB for the CSS).

Note: This extension depends on the kartik-v/yii2-widgets extension which in turn depends on the yiisoft/yii2-bootstrap extension. Check the composer.json for this extension's requirements and dependencies. Note: Yii 2 framework is still in active development, and until a fully stable Yii2 release, your core yii2-bootstrap packages (and its dependencies) may be updated when you install or update this extension. You may need to lock your composer package versions for your specific app, and test for extension break if you do not wish to auto update dependencies.

Demo ¶

You can see detailed documentation and demonstration on usage of the extension.

Installation ¶

The preferred way to install this extension is through composer.

Either run:

$ php composer.phar require kartik-v/yii2-checkbox-x "*"

or add:

"kartik-v/yii2-checkbox-x": "*"

to the require section of your composer.json file.

Usage ¶

use kartik\checkbox\CheckboxX;
echo CheckboxX::widget([
    'model' => $model,
    'attribute' => 'status',
    'pluginOptions' => [
        'threeState' => true,
        'size' => 'lg'
    ]
]);

Report ¶

• Report any issues on the project page
• Use the forum page for any discussions on this extension

License ¶

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

Resources ¶

• Github Project
• Packagist Package
• Documentation & Demo