Wallogit.com
2017 © Pedro Peláez
Generates a list of checkboxes for multi selection.
This library can be used to generate a multichoice field. I recommend you take a look at the documentation of its parent classes in order to grasp all the inherited functionality:, (*1)
Via composer:, (*2)
composer require flsouto/htcklist
In the following example we generate a list which allows a user to pick multiple days of the week., (*3)
<?php
use FlSouto\HtCklist;
require("vendor/autoload.php");
$select = new HtCklist("select_days");
$select->options([1=>'Mon',2=>'Tue',3=>'Wed',4=>'Thu',5=>'Fri',6=>'Sat']);
echo $select;
Outputs:, (*4)
Notice: the options method also accepts other formats besides an associative array. Take a look at the documentation of the HtChoice class in order to learn more., (*5)
By default, the separator used to separate the options is a <br/> element, that is, a line break.
But you can change that by using the separator method. In the example below we change the separator to be two spaces so that the options are displayed horizontally:, (*6)
<?php
use FlSouto\HtCklist;
require("vendor/autoload.php");
$select = new HtCklist("select_days");
$select->options([1=>'Mon',2=>'Tue',3=>'Wed',4=>'Thu',5=>'Fri',6=>'Sat'])
->separator(" ");
echo $select;
Outputs:, (*7)
If you have read the documentation of the HtField and the HtWidget parent classes you already know that you are supposed
to use the context method in order to populate the value of a field/widget. In this case, you have to pass an array with the values
of the options you want to be checked when the field is displayed:, (*8)
<?php
use FlSouto\HtCklist;
require("vendor/autoload.php");
$select = new HtCklist("select_days");
$select->options([1=>'Mon',2=>'Tue',3=>'Wed',4=>'Thu',5=>'Fri',6=>'Sat']);
$select->context(['select_days'=>[2,5]]); // check Tue and Fri
echo $select;
Outputs:, (*9)
Generates a list of checkboxes for multi selection.
html forms widgets options fields choices multichoice
Generates a list of checkboxes for multi selection.
html forms widgets options fields choices multichoice