使用PHP动态填充HTML下拉列表框的教程

<select id="listObject" name="listObject" size="number_of_options" multiple="multiple" style="width:90%; height:300px">
    <option value="option1">1</option>
    <option value="option2">2</option>
    <option value="Option3">3</option>
</select>

<?php

class HtmlGenerator
{
    /**
     * 动态填充HTML下拉列表框。
     *
     * @param string $dataMethodName 用于获取选项数据的方法名。该方法应返回一个键值对数组。
     * @param string $id 下拉列表框的HTML ID属性。
     * @param string $name 下拉列表框的HTML name属性。
     * @param string|null $selected 可选参数，指定默认选中的选项值。
     * @return string 生成的HTML <select> 标签字符串。
     */
    public function populate_listbox(string $dataMethodName, string $id, string $name, ?string $selected = null): string
    {
        // 验证数据获取方法是否存在
        if (!method_exists($this, $dataMethodName)) {
            // 可以选择抛出异常或返回一个空的select标签
            error_log("Error: Data method '{$dataMethodName}' does not exist in " . get_class($this));
            return '<select id="' . htmlspecialchars($id) . '" name="' . htmlspecialchars($name) . '"></select>';
        }

        // 动态调用方法获取数据
        $data = $this->$dataMethodName();

        $html = '<select id="' . htmlspecialchars($id) . '" name="' . htmlspecialchars($name) . '">';
        foreach ($data as $key => $value) {
            // 对选项值和显示文本进行HTML实体编码，防止XSS攻击
            $encodedKey = htmlspecialchars((string)$key);
            $encodedValue = htmlspecialchars((string)$value);

            $isSelected = ($key == $selected) ? 'selected' : '';
            $html .= '<option value="' . $encodedKey . '" ' . $isSelected . '>' . $encodedValue . '</option>';
        }
        $html .= '</select>';
        return $html;
    }

    /**
     * 示例：获取下拉列表选项数据的方法。
     * 实际应用中，这可能从数据库、文件或API中获取数据。
     *
     * @return array 键值对数组，键为选项的value，值为选项的显示文本。
     */
    public function getCategoryOptions(): array
    {
        // 假设这些数据来自数据库查询
        return [
            'tech' => '技术',
            'science' => '科学',
            'art' => '艺术',
            'history' => '历史',
            'sports' => '体育'
        ];
    }

    /**
     * 另一个示例：获取用户列表选项数据。
     * @return array
     */
    public function getUserOptions(): array
    {
        return [
            'user123' => '张三',
            'user456' => '李四',
            'user789' => '王五'
        ];
    }
}

?>

<?php
// 引入包含 HtmlGenerator 类的文件
// require_once 'HtmlGenerator.php'; // 如果类在单独文件中

// 实例化 HTML 生成器
$generator = new HtmlGenerator();

// 示例1：生成一个分类选择下拉列表，默认选中“科学”
$categorySelect = $generator->populate_listbox('getCategoryOptions', 'categorySelect', 'categories', 'science');
echo "<h3>选择一个分类：</h3>";
echo $categorySelect;
echo "<br><br>";

// 示例2：生成一个用户选择下拉列表，无默认选中
$userSelect = $generator->populate_listbox('getUserOptions', 'userSelect', 'users');
echo "<h3>选择一个用户：</h3>";
echo $userSelect;
echo "<br><br>";

// 示例3：尝试使用不存在的数据方法
$invalidSelect = $generator->populate_listbox('getNonExistentOptions', 'invalidSelect', 'invalid');
echo "<h3>尝试使用不存在的方法：</h3>";
echo $invalidSelect; // 会在日志中记录错误，并输出一个空的select标签

?>

<h3>选择一个分类：</h3>
<select id="categorySelect" name="categories">
    <option value="tech">技术</option>
    <option value="science" selected>科学</option>
    <option value="art">艺术</option>
    <option value="history">历史</option>
    <option value="sports">体育</option>
</select>

<br><br>
<h3>选择一个用户：</h3>
<select id="userSelect" name="users">
    <option value="user123">张三</option>
    <option value="user456">李四</option>
    <option value="user789">王五</option>
</select>

<br><br>
<h3>尝试使用不存在的方法：</h3>
<select id="invalidSelect" name="invalid"></select>