1. Latest Release
2. Form
3. FormGrid
4. Tabular Form
5. Requirements
6. Installation
7. Demo
8. Usage
9. Report
10. License
11. Resources

A form builder extension that allows you to build both single-row and multi-row/tabular forms for Yii Framework 2.0. The extension contains these widgets:

Latest Release ¶

The latest version of the module is v1.2.0 released on 07-Nov-2014. Refer the CHANGE LOG for details.

Form ¶

VIEW DEMO

The Form Builder widget allows you to build a form through a configuration array. Key features available:

• Configure your form fields from a model extending yii\base\model or yii\db\ActiveRecord.
• Ability to support various Bootstrap 3.x form layouts. Uses the advanced kartik\widgets\ActiveForm.
• Use Bootstrap column/builder layout styling by just supplying columns property.
• Build complex layouts (for example single, double, or multi columns in the same layout) - by reusing the widget for building your attributes.
• Tweak ActiveForm defaults to control field options, styles, templates, and layouts.
• Various Bootstrap 3.x styling features are available by default. However, one can easily customize and theme it to one's liking using any CSS framework.
• Supports and renders HTML input types (uses kartik\widgets\ActiveField) including input widgets and more:
  • INPUT_TEXT or textInput
  • INPUT_TEXTAREA or textarea
  • INPUT_PASSWORD or passwordInput
  • INPUT_DROPDOWN_LIST or dropdownList
  • INPUT_LIST_BOX or listBox
  • INPUT_CHECKBOX or checkbox
  • INPUT_RADIO or radio
  • INPUT_CHECKBOX_LIST or checkboxList
  • INPUT_RADIO_LIST or radioList
  • INPUT_MULTISELECT or multiselect
  • INPUT_STATIC or staticInput
  • INPUT_FILE or fileInput
  • INPUT_HTML5 or input
  • INPUT_WIDGET or widget
  • INPUT_RAW or raw (any free text or html markup)

Refer the documentation for more details.

FormGrid ¶

VIEW DEMO

Create bootstrap grid layouts in a snap. The Form Grid Builder widget offers an easy way to configure your form inputs as a bootstrap grid layout and a single array configuration. It basically uses multiple instances of the \kartik\builder\Form widget above to generate this grid. One needs to just setup the rows for the grid, where each row will be an array configuration as needed by the Form widget. However, most of the common settings like model, form, columns etc. can be defaulted at FormGrid widget level.

Tabular Form ¶

VIEW DEMO

The tabular form allows you to update information from multiple models (typically used in master-detail forms). Key features

• Supports all input types as mentioned in the Form builder widget
• The widget works like a Yii GridView and uses an ActiveDataProvider to read the models information.
• Supports features of the builderview like pagination and sorting.
• Allows you to highlight and select table rows
• Allows you to add and configure action buttons for each row.
• Various Bootstrap 3.x styling features are available by default. However, one can easily customize and theme it to one's liking using any CSS framework.
• Advanced table styling, columns, and layout configuration by using the features available in the [`kartik\builder\GridView`](kartik\widgets\ActiveForm widget.
• One can easily read and manage the tabular input data using the loadMultiple and validateMultiple functions in yii\base\Model.

Requirements ¶

• Yii 2.0 (dev-master)
• PHP 5.4
• Twitter Bootstrap 3.0

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.

Installation ¶

The preferred way to install this extension is through composer.

Either run:

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

or add:

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

to the require section of your composer.json file.

Demo ¶

You can see detailed documentation on usage of the extension.

Usage ¶

Form ¶

use kartik\builder\Form;
use kartik\widgets\ActiveForm;
$form = ActiveForm::begin();
echo Form::widget([
    'model' => $model,
    'form' => $form,
    'columns' => 2,
    'attributes' => [
        'username' => ['type'=>Form::INPUT_TEXT, 'options'=>['placeholder'=>'Enter username...']],
        'password' => ['type'=>Form::INPUT_PASSWORD, 'options'=>['placeholder'=>'Enter password...']],
        'rememberMe' => ['type'=>Form::INPUT_CHECKBOX],
    ]
]);
ActiveForm::end();

FormGrid ¶

use kartik\builder\Form;
use kartik\builder\FormGrid;
$form = ActiveForm::begin();
echo FormGrid::widget([
    'model' => $model,
    'form' => $form,
    'autoGenerateColumns' => true,
    'rows' => [
        [
            'attributes' => [
                'username' => ['type'=>Form::INPUT_TEXT],
                'password' => ['type'=>Form::INPUT_PASSWORD],
                'rememberMe' => ['type'=>Form::INPUT_CHECKBOX],
            ],
        ],
        [
            'attributes' => [
                'first_name' => ['type'=>Form::INPUT_TEXT],
                'last_name' => ['type'=>Form::INPUT_TEXT],
            ]
        ]
    ]
]);
ActiveForm::end();

TabularForm ¶

use kartik\builder\TabularForm;
use kartik\widgets\ActiveForm;
$form = ActiveForm::begin();
echo TabularForm::widget([
    'form' => $form,
    'dataProvider' => $dataProvider,
    'attributes' => [
        'id' => ['type' => TabularForm::INPUT_STATIC, 'columnOptions'=>['hAlign'=>GridView::ALIGN_CENTER]],
        'name' => ['type' => TabularForm::INPUT_TEXT],
        'color' => [
            'type' => TabularForm::INPUT_WIDGET, 
            'widgetClass' => \kartik\widgets\ColorInput::classname()
        ],
        'author_id' => [
            'type' => TabularForm::INPUT_DROPDOWN_LIST, 
            'items'=>ArrayHelper::map(Author::find()->orderBy('name')->asArray()->all(), 'id', 'name')
        ],
        'buy_amount' => [
            'type' => TabularForm::INPUT_TEXT, 
            'options'=>['class'=>'form-control text-right'], 
            'columnOptions'=>['hAlign'=>GridView::ALIGN_RIGHT]
        ],
        'sell_amount' => [
            'type' => TabularForm::INPUT_STATIC, 
            'columnOptions'=>['hAlign'=>GridView::ALIGN_RIGHT]
        ],
    ],
    'gridSettings' => [
        'floatHeader' => true,
        'panel' => [
            'heading' => '<h3 class="panel-title"><i class="glyphicon glyphicon-book"></i> Manage Books</h3>',
            'type' => GridView::TYPE_PRIMARY,
            'after'=> 
                Html::a(
                    '<i class="glyphicon glyphicon-plus"></i> Add New', 
                    $createUrl, 
                    ['class'=>'btn btn-success']
                ) . '&nbsp;' . 
                Html::a(
                    '<i class="glyphicon glyphicon-remove"></i> Delete', 
                    $deleteUrl, 
                    ['class'=>'btn btn-danger']
                ) . '&nbsp;' .
                Html::submitButton(
                    '<i class="glyphicon glyphicon-floppy-disk"></i> Save', 
                    ['class'=>'btn btn-primary']
                )
        ]
    ]     
]); 
ActiveForm::end(); 

Report ¶

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

License ¶

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

Resources ¶

• Github Project
• Packagist Package
• Documentation & Demo