• Overview
• Use manual data inputs
• Multiple selection in Select2
• Client events

Select2

Overview #

Select2 is a great UI control to replace the normal select box. It gives you a customizable select box with support for searching, tagging, remote data sets, infinite scrolling, and many other highly used options. View examples of Select2.

To use Select2 in KoolReport, you do:

<?php
Select2::create(array(
    'name'=>"my_select2",
    "placeholder"=>"Select customer",
    "dataStore"=>$this->dataStore("customers"),
    "dataBind"=>array(
        "text"=>"customerName",
        "value"=>"customerId",
    ),
));
?>

Use manual data inputs #

If you do not want to use dataBinding, you can input select options manually.

<?php
Select2::create(array(
    'name'=>"my_select2",
    "placeholder"=>"Select customer",
    "data"=>array(
        "John Doe"=>"1",
        "Jane Doe"=>"2",
        "Whatever Doe"=>"3",
    )    

));
?>

Multiple selection in Select2 #

Select2 support multiple selection. View the multiple selection example. To enable the multi-select feature of Select2 in KoolReport, you do:

<?php
Select2::create(array(
    'name'=>"my_select2",
    "multiple"=>true,
    "placeholder"=>"Select customers",
    "dataStore"=>$this->dataStore("customers"),
    "dataBind"=>array(
        "text"=>"customerName",
        "value"=>"customerId",
    ),
));
?>

Client events #

Select2 supports following events:

<?php
Select2::create(array(
    ...
    "clientEvents"=>array(
        "change"=>"function(e){
            \\Do something
        }",
    )
));
?>