flsouto/htselect

Generates the classic HTML Select field for choosing an option.

HtSelect

This library can be used to generate <select> fields in an easy way. I recommend you take a look at the documentation of its parent classes in order to grasp all the functionality inherited by this particular one:, _(*1)

• HtChoice
• HtWidget
• HtField

Installation

Via composer:, _(*2)

composer require flsouto/htselect

Usage

In the following example we generate a select field with three options., _(*3)

<?php
require_once('vendor/autoload.php');
use FlSouto\HtSelect;

$select = new HtSelect("id_category");
$select->options([1=>'Category1',2=>'Category2',3=>'Category3']);

echo $select;

Outputs:, _(*4)

 
   Category1
   
   Category2
   
   Category3
   
 
 

 

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)

Selecting an option

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 set the value of a field/widget:, _(*6)

<?php
require_once('vendor/autoload.php');
use FlSouto\HtSelect;

$select = new HtSelect('id_category');
$select->options([1=>'Category1',2=>'Category2',3=>'Category3']);
$select->context(['id_category'=>2]);

echo $select;

Outputs:, _(*7)

 
   Category1
   
   Category2
   
   Category3
   
 
 

 

Setting a caption

The "caption" is the default text which appears on the select field when no option has been selected yet. This is usally a message indicating that the user should choose something:, _(*8)

<?php
require_once('vendor/autoload.php');
use FlSouto\HtSelect;

$select = new HtSelect('id_category');
$select->options([1=>'Category1',2=>'Category2',3=>'Category3']);
$select->caption('CHOOSE A CATEGORY:');

echo $select;

Outputs:, _(*9)

 
   CHOOSE A CATEGORY:
   
   Category1
   
   Category2
   
   Category3
   
 
 

 

Notice that by default the value "0" is used for the caption option. This means that when the form gets sent, if no option has been selected, then the "0" value will be sent as the category id, which in most cases would mean "no category". However, you can change that value if you want by using a second paramenter to the caption method:, _(*10)

<?php
require_once('vendor/autoload.php');
use FlSouto\HtSelect;

$select = new HtSelect('id_category');
$select->options([1=>'Category1',2=>'Category2',3=>'Category3']);
$select->caption('CHOOSE A CATEGORY:', 'none'); # change value to 'none'

echo $select;

Outputs:, _(*11)

 
   CHOOSE A CATEGORY:
   
   Category1
   
   Category2
   
   Category3