
本文档旨在指导开发者如何在 Moodle 表单的 `select` 组件中,将数据库中的实际 ID 值作为选项值传递,而非默认的索引值。通过使用 `get_records_menu` 函数简化数据获取,并结合 `set_data` 方法设置表单数据,实现选项值的正确传递。
在 Moodle 表单开发中,select 组件常用于提供下拉选择功能。 默认情况下,addElement('select', ...) 方法会将数组的键(key)作为
使用 get_records_menu 函数
Moodle 提供了 get_records_menu 函数,可以方便地从数据库中获取数据,并将其格式化为适合 select 组件使用的数组。 该函数接受表名、查询条件、排序字段和要返回的字段作为参数。
以下代码演示了如何使用 get_records_menu 函数从 m_tl_mastercourse 表中获取 id 和 name 字段,并将 id 作为选项值, name 作为选项文本:
global $DB;
$options = $DB->get_records_menu('m_tl_mastercourse', [], 'id', 'id, name');
$mform->addElement('select', 'master_id', get_string('selectcourse'), $options);在上述代码中:
- $DB 是 Moodle 的数据库连接对象。
- 'm_tl_mastercourse' 是要查询的表名。
- [] 表示没有查询条件。
- 'id' 表示按照 id 字段排序。
- 'id, name' 表示要返回 id 和 name 字段。
- $options 变量将包含一个数组,其键为 id 值,值为 name 值,例如:[1 => 'php01', 2 => 'ios01', 3 => 'and01']。
- $mform->addElement('select', 'master_id', get_string('selectcourse'), $options) 将使用 $options 数组生成 select 组件。
生成的 HTML 代码如下所示:
设置表单数据
为了在编辑表单时预先选中某个选项,需要使用 set_data 方法设置表单数据。 以下代码演示了如何将 master_id 设置为 99:
$formdata = new \stdClass(); $formdata->master_id = 99; $mform = new edit_form(); $mform->set_data($formdata); $mform->display();
在上述代码中:
- $formdata 是一个 stdClass 对象,用于存储表单数据。
- $formdata->master_id = 99 将 master_id 的值设置为 99。
- $mform->set_data($formdata) 将表单数据传递给表单对象。
- $mform->display() 显示表单。
总结
通过使用 get_records_menu 函数和 set_data 方法,可以方便地将数据库中的实际 ID 值作为 Moodle select 组件的选项值传递,并在编辑表单时预先选中某个选项。 这使得表单开发更加灵活和高效。
注意事项:
- 确保数据库连接 $DB 已正确初始化。
- 确保表名和字段名在数据库中存在。
- 在设置表单数据时,确保数据类型与数据库字段类型匹配。










