README

此库可以轻松生成 <select> 字段。我建议您查看其父类的文档，以了解此特定类继承的所有功能。

• HtChoice
• HtWidget
• HtField

安装

通过 composer

composer require flsouto/htselect

用法

在以下示例中，我们生成一个包含三个选项的选择字段。

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

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

echo $select;

输出

<div class="widget 58b597bc2668e" style="display:block">
 <select name="id_category">
   <option value="1">Category1
   </option>
   <option value="2">Category2
   </option>
   <option value="3">Category3
   </option>
 </select>
 <div style="color:yellow;background:red" class="error">
 </div>
</div>

注意：除了关联数组之外，options 方法还接受其他格式。请查看HtChoice 类的文档以了解更多信息。

选择一个选项

如果您已经阅读了 HtField 和 HtWidget 父类的文档，您已经知道您应该使用 context 方法来设置字段/小部件的值。

<?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;

输出

<div class="widget 58b597bc2821a" style="display:block">
 <select name="id_category">
   <option value="1">Category1
   </option>
   <option value="2" selected="selected">Category2
   </option>
   <option value="3">Category3
   </option>
 </select>
 <div style="color:yellow;background:red" class="error">
 </div>
</div>

设置标题

"标题"是默认文本，当没有选择任何选项时出现在选择字段上。这通常是一条消息，指示用户应该选择某个选项。

<?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;

输出

<div class="widget 58b597bc288a0" style="display:block">
 <select name="id_category">
   <option value="0">CHOOSE A CATEGORY:
   </option>
   <option value="1">Category1
   </option>
   <option value="2">Category2
   </option>
   <option value="3">Category3
   </option>
 </select>
 <div style="color:yellow;background:red" class="error">
 </div>
</div>

请注意，默认情况下，标题选项使用值 "0"。这意味着当表单发送时，如果没有选择任何选项，则将 "0" 值作为类别 ID 发送，在大多数情况下这意味着 "无类别"。但是，您可以通过向 caption 方法传递第二个参数来更改该值。

<?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;

输出

<div class="widget 58b597bc28eef" style="display:block">
 <select name="id_category">
   <option value="none">CHOOSE A CATEGORY:
   </option>
   <option value="1">Category1
   </option>
   <option value="2">Category2
   </option>
   <option value="3">Category3
   </option>
 </select>
 <div style="color:yellow;background:red" class="error">
 </div>
</div>